Sample cURL

curl -L -g 'https://eu.api.capillarytech.com}/v2/card' \
-H 'Content-Type: application/json' \
-d '{
    "cardNumber": "warsawcustomc26",
    "seriesId": 23,
    "statusLabel": "new",
    "statusInfo": {
        "reason": "Change in card status"
    },
    "mappedEntity": {
        "type": "TILL",
        "value": "paw1",
        "id": 50016843
    },
    "customFields": {
        "budapest": "field1",
        "type": "type1",
        "name": ""
    },
    "extendedFields": {
        "vehicle_make": "2021"
    }
}'

Request Body Parameters

Parameter	Data Type	Description
cardNumber*	String	Unique card number or external card identifier to search for the card details.
cardExternalId	Boolean	Indicates whether the `cardNumber` provided is an external identifier (if `true`) or an internal card number (if `false`).

API Specific Error Code

Code	Description	Reason
400	Bad Request	The request was invalid or malformed, often due to missing or incorrect parameters.
401	Unauthorized	Authentication failed or the API credentials are missing or incorrect.
404	Not Found	The requested resource (e.g., card or configuration) could not be found.
409	Conflict	The request conflicts with the current state of the resource (e.g., duplicate entries).
422	Unprocessable Entity	The request was well-formed but could not be processed due to semantic errors.
500	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request.