Get Service Provider Token

GET/api/v1/tokens/{identifier}

Retrieve service provider token information. The identifier path parameter can be either:

A customer_id — returns a list of all service provider tokens for that customer.
A token_id — returns a single service provider token by its unique ID.

The response structure varies based on whether a customer_id or token_id is provided.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Field	Details
`identifier` `string`required	Customer ID or Token ID. When a customer_id is provided, returns all service provider tokens for that customer. When a token_id is provided, returns the specific token details.

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Response

Field	Details
`ServiceProviderTokensListResponse` `object`2 nested fieldsoneOf option	Response containing a list of service provider tokens for a customer.
`customer_id` `string`	Unique identifier of the customer.
`tokens` `ServiceProviderTokenResponse[]`9 nested fields	List of service provider tokens.
`ServiceProviderTokenResponse` `object`9 nested fieldsoneOf option	Response object containing service provider token information.

Status Codes

`200`	Service provider token(s) retrieved successfully.
`400`	The request was malformed or missing required fields.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`403`	The authenticated client does not have permission for this operation.
`404`	The requested resource does not exist.
`500`	An unexpected error occurred on the server.
`503`	Service temporarily unavailable.

Run

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/v1/tokens/token-v1-1234567890-aa-ABCDEF \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'

Status:

{
  "customer_id": "cust-v1-0811030624-aa-RBDgpR",
  "tokens": [
    {
      "token_id": "token-v1-1234567890-aa-ABCDEF",
      "customer_id": "cust-v1-0811030624-aa-RBDgpR",
      "merchant_token_reference": "token-ref-001",
      "status": "ACTIVE",
      "payment_method": "CARD",
      "card_details": {
        "last4_digit": "1112",
        "card_type": "CREDIT",
        "network_name": "Visa",
        "issuer_name": "HDFC Bank",
        "card_category": "CONSUMER",
        "country_code": "IN",
        "international": false,
        "emi": true,
        "cvv_required": true
      },
      "service_provider_token_id": "sp-token-001",
      "created_at": "2024-10-04T13:11:29.645591Z",
      "updated_at": "2024-10-04T13:11:29.645657Z"
    }
  ]
}