Integration

API GetCID

Use this endpoint to request a CID from an IID with your reseller token. The request is forwarded transparently to the current GetCID engine and tracked inside HydraCID X.

GetCID flow

Main endpoint

GEThttps://bs.hydracidx.com/api/getcid/?iid=3344819562788749725844623802640937166926&lang=en

Send the same IID again to check whether the CID is already available. Pending requests return a message until the engine finishes.

Integration options

This service is provided by getcid.xyz.
A WordPress plugin is also available for a simpler integration, as long as it connects directly to getcid.xyz.
For advanced tools such as reporting, open a separate account at getcid.xyz.
getcid.xyz uses its own account and credit balance.
If you only need a simple flow, this API is enough.

Authorization

Authentication uses the same reseller static `url_token` as API Purchases.
Send the token in the `Authorization` header using the `Token` scheme.
The request is billed against your reseller CID cost only once per reseller and resolved request.

Header example

Authorization: Token YOUR_STATIC_URL_TOKEN

How it works

Send the IID with your reseller API token.
If the CID is ready, the response returns it immediately.
If processing is still running, the response returns a pending message.
Repeat the same request with the same IID until the response includes `cid`.

Request parameters

Use query parameters in a `GET` request.

Query string

iid

string

Installation ID to be resolved into a CID.

Required.
Use the raw IID without extra labels.
The same IID can be queried again to obtain the final CID.

lang

string

Language used by the underlying GetCID response messages.

Optional.
Default value: en.
Accepted values: en, es, pt, zh, ru, fr, ar, id, hi, tr, pl.

Request examples

Ready to use

cURL

curl --request GET \
  --url "https://hydracidx.com/api/getcid/?iid=3344819562788749725844623802640937166926&lang=en" \
  --header "Authorization: Token YOUR_STATIC_URL_TOKEN"

Ready response

{
  "cid": "061926-425994-646356-060122-971232-510511-076149-214366",
  "c_cid": "061926425994646356060122971232510511076149214366"
}

Pending response

{
  "errorDetail": "Request sent. Check again in a moment."
}

Invalid IID response

{
  "errorDetail": "Invalid Installation ID."
}

Internal tracking

Every accepted GetCID API request is stored in HydraCID X.
The underlying GetCID request source is registered as `HydraCidX Api`.
The final CID detail is linked to the internal `CallRq` resolution flow.

Important notes

The endpoint uses your reseller CID cost configured in HydraCID X.
If your reseller credit is insufficient, the request is rejected before reaching the GetCID engine.
Use the same IID when polling so you reuse the original request instead of creating unrelated lookups.

Menu