For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get User Requests List

Retrieves a paginated list of operation requests (ISSUE, TOPUP, WITHDRAWAL, BLOCK) by user account.

Endpoint: GET /requests

Query Parameters:

Parameter
Type
Required
Description

limit

Number

Yes

Maximum number of records to return (max 100)

offset

Number

Yes

Number of records to skip for pagination (0-based)

Response:

{
  "count": 6,
  "requests": [
    {
      "status": "EXECUTED",
      "san": "222-333-44-55",
      "type": "BLOCK",
      "docid": 36282228,
      "request_id": "block-101-00465",
      "created": "2025-07-03T09:21:55.605Z"
    },
    {
      "status": "EXECUTED",
      "san": "222-333-44-56",
      "type": "WITHDRAWAL",
      "docid": 36282762,
      "request_id": "withdraw0000009",
      "created": "2025-07-03T09:20:55.605Z"
    },
    {
      "status": "EXECUTED",
      "san": "222-333-44-9999",
      "type": "WITHDRAWAL",
      "docid": 32822740,
      "request_id": "withdraw0000008",
      "created": "2025-07-03T09:19:55.605Z"
    },
    {
      "status": "EXECUTED",
      "san": "222-333-44-56657",
      "type": "TOPUP",
      "docid": 362782718,
      "request_id": "topup-100-06-493",
      "created": "2025-07-03T09:18:55.605Z"
    },
    {
      "status": "EXECUTED",
      "san": "222-333-44-55",
      "type": "ISSUE",
      "docid": 362888674,
      "request_id": "issue-100-001-00",
      "created": "2025-07-03T09:15:55.605Z"
    }
  ]
}

Response Parameters:

Field
Type
Description

count

Number

Total number of matching records (for pagination)

requests

Array

Array of response objects

requests[].created

String (ISO 8601)

Request created timestamp in UTC

requests[].type

String

Operation type(see Operation Values below)

requests[].san

String

Secure Account Number (card identifier)

requests[].status

String

Current status of the operation (see Status Values below)

requests[].docid

Number

Document ID for tracking the operation

requests[].request_id

String

The request ID provided in the original request

Operation Types:

  • ISSUE - Card issuance

  • TOPUP - Card top-up

  • WITHDRAWAL - Card withdrawal

  • BLOCK - Card blocking

Status Values:

  • INPROCESS - Operation is currently being processed

  • EXECUTED - Operation completed successfully

  • DECLINED - Operation was declined

Last updated