Retrieves the log of status changes of a card number.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
This API retrieves the status change history for a specific card. Each log entry includes the timestamp, previous and current status labels, and the user who made the change. Use this API to audit card lifecycle events or troubleshoot status-related issues.
NoteFor detailed information about the APIs and for hands-on testing, refer to the API overview documentation and step-by-step guide on making your first API call.
Prerequisites
- Basic Authentication
- Default access group
Resource information
| HTTP method | GET |
|---|---|
| Authentication | Basic |
| Pagination supported? | NO |
| Rate limit | YES |
| Batch support | NO |
Example request
curl --location 'https://eu.api.capillarytech.com/v2/card/statusLog?number=GOLD00000000000001012020' \
--header 'Authorization: Basic ='Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| number | string | Yes | Card number to get status log. |
Example response
{
"data": [
{
"reason": "",
"createdBy": 0,
"actions": [],
"autoUpdateTime": "2021-01-10",
"createdOn": "2021-01-10T10:39:19Z",
"entityId": 10609,
"isActive": false,
"label": "CARD GENERATED",
"status": "NOT_ISSUED"
},
{
"reason": "",
"createdBy": 0,
"actions": [],
"autoUpdateTime": "2021-01-10",
"createdOn": "2021-01-10T10:40:25Z",
"entityId": 10609,
"isActive": false,
"label": "ACTIVE",
"status": "ACTIVE"
},
{
"reason": "",
"createdBy": 0,
"actions": [],
"autoUpdateTime": "2021-01-10",
"createdOn": "2021-01-10T12:01:39Z",
"entityId": 10609,
"isActive": false,
"label": "SUSPENDED",
"status": "SUSPENDED"
},
{
"reason": "",
"createdBy": 0,
"actions": [],
"autoUpdateTime": "2021-01-10",
"createdOn": "2021-01-10T12:02:00Z",
"entityId": 10609,
"isActive": false,
"label": "ACTIVE",
"status": "ACTIVE"
},
{
"reason": "",
"createdBy": 0,
"actions": [],
"autoUpdateTime": "2021-01-10",
"createdOn": "2021-01-10T12:02:39Z",
"entityId": 10609,
"isActive": true,
"label": "EXPIRED",
"status": "EXPIRED"
}
],
"warnings": [],
"errors": []
}Response parameters
| Parameter | Type | Description |
|---|---|---|
| data | array[object] | List of status log entries. |
| string | Reason for the status change, if provided. |
| integer | Entity ID of the user or system that created this status entry. A value of 0 indicates an automated system change. |
| array | List of actions that are permitted for this status. |
| string | Date when the status was automatically updated (format: YYYY-MM-DD). |
| string | Timestamp when the status entry was created in ISO 8601 format, returned in the server time zone. EU server example 2026-04-20T12:02:55Z → 20 April 2026, 12:02:55 (UTC) India server example 2026-04-20T17:32:55+05:30 → 20 April 2026, 17:32:55 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request. |
| integer | Unique identifier of the card associated with this status entry. |
| boolean | Indicates whether this is the current active status. true for the most recent status; false for historical entries. |
| string | Human-readable label for the status (e.g., CARD GENERATED, ACTIVE, SUSPENDED, EXPIRED). |
| string | Internal status code. Possible values: NOT_ISSUED, ACTIVE, SUSPENDED, EXPIRED, DELETED. |
| warnings | array | List of warning messages, if any. |
| errors | array | List of error messages, if the request failed. |
Card status values
| Status | Description |
|---|---|
| NOT_ISSUED | Card has been generated but not yet issued to a customer. |
| ACTIVE | Card is active and can be used for transactions. |
| SUSPENDED | Card is temporarily suspended. It can be reactivated. |
| EXPIRED | Card has expired and cannot be used. |
| DELETED | Card has been permanently deleted. |
API-specific error codes
| Error Code | Description | Reason |
|---|---|---|
| 400 | Bad Request | Invalid input parameters |
| 401 | Unauthorized | Missing or invalid authentication token |
| 404 | Not Found | Incorrect URL or endpoint |
| 500 | Internal Server Error | Unexpected server failure (contact support) |
| 3010 | Card number does not exist | The specified card number was not found |