Info

Returns the details and the current status of a recurring profile.

Find the profile by profile_id or by external_id.

The method asks the payment system for the current status of the profile.

Without state_callback in Create, call this method until the profile becomes active or reaches a final status.

Profile status flow

Statuses are the values of status.

Status	Meaning
`process`	The profile is created and waits for the client to confirm it.
`active`	The client confirmed the profile: it can be charged with Execute.
`canceled`	The profile is cancelled with Cancel.
`expired`	The profile expired: `expires_at` has passed.
`error`	The payment system did not create the profile.

Label	Meaning
confirmed	The client confirmed the profile in the app of the payment system.
rejected	The payment system did not create the profile.
cancelled	The merchant cancelled the profile with Cancel.
expired	`expires_at` has passed.

Result

HTTP	Meaning	Next step
`200`	The profile is returned.	If `status = process`, repeat the request later.
`400`, `401`, `422`, `500`	The request is rejected.	See «Errors» below.

Errors

The error is returned in error_description; error_code is returned for 401, 422 and for the 400 errors that have a code below.

HTTP	`error_code`	When	What to do
`400`	`3001`	The profile is not found.	Check `profile_id` or `external_id`.
`401`	`9998`	The signature is invalid.	Check the signature: see Overview.
`422`	`9403`	The X-JWS-Signature header is missing.	Pass the signature.
`500`	—	Neither `profile_id` nor `external_id` is passed, or `profile_id` is not 32 hexadecimal characters. `error_description` names the field.	Fix the request.

Responses

🟢200Success

application/json

Headers

Bodyapplication/json

Example

{
    "status": "active",
    "invoice_type": "binance",
    "profile_id": "9f8e7d6c5b4a39281706f5e4d3c2b1a0",
    "external_id": "sub1001",
    "agreement_type": "on-demand",
    "expires_at": "2027-10-30",
    "created_at": "2026-10-30T13:48:47+05:00",
    "additional": {
        "scene_code": "SUBSCRIPTION"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Profile status flow#

Result#

Errors#

Request

Responses

Profile status flow

Result

Errors