Kobble
  1. Card Programs
Kobble
  • Introduction
  • Authorization
    • Authorization
    • Get access token
      POST
  • Beneficiaries
    • List all beneficiaries
      GET
    • Get beneficiary by ID
      GET
    • Create beneficiary
      POST
    • Update beneficiary
      PUT
  • Cards
    • Cards API
    • Get all cards
      GET
    • Create a new card
      POST
    • Get card by ID
      GET
    • Update card status
      PATCH
    • Replace or renew card
      POST
    • Generate card secret
      POST
  • Card Programs
    • Card Programs API
    • Get all programs
      GET
    • Create a new program
      POST
    • Get program by ID
      GET
  • Clients
    • Clients API
    • Get all clients
      GET
    • Get client by ID
      GET
    • Create a new client
      POST
    • Update client status
      PATCH
  • Endusers
    • Endusers API
    • Get all endusers
      GET
    • Create a new enduser
      POST
    • Get enduser by ID
      GET
  • Transactions
    • Transactions API
    • Get all transactions
    • Create a transaction
    • Get transaction by ID
    • Create manual credit transaction
    • Create manual debit transaction
  • Wallets
    • Wallets API
    • Get all wallets
    • Create a new wallet
    • Get wallet by ID
    • Update wallet
  • Relays
    • Relays API
    • Create subscription
  • Webhooks
    • Webhooks API
    • Get all webhooks
    • Create a webhook
    • Delete a webhook
  1. Card Programs

Get program by ID

GET
/customers/v1/card-programs/{id}
Card Programs
Retrieve a program's details by its unique identifier.

Request

Path Params
id
string 
required
Program id
Header Params
Content-Type
string 
required
Example:
application/json
Authorization
string 
required
Example:
Bearer {{access_token}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/customers/v1/card-programs/' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200OK
application/json
Body
A program object representing a card program.
id
string <uuid>
required
The unique identifier of the program.
type
enum<string> 
required
The type of program (virtual or physical).
Allowed values:
VIRTUALPHYSICAL
created_at
string <date-time>
required
The date and time the program was created.
updated_at
string <date-time>
required
The date and time the program was last updated.
status
enum<string> 
required
The current status of the program.
Allowed values:
ACTIVEINACTIVE
partner_product
enum<string> 
required
The partner product associated with the program.
Allowed value:
KOBBLE_DEBIT_1
metadata
object 
required
Metadata specific to the program.
Example
{
    "id": "3712bf11-699b-4f40-b1bc-199fe9c0d2a4",
    "type": "PHYSICAL",
    "created_at": "2025-01-14T16:29:30.412Z",
    "updated_at": "2025-01-14T16:29:30.412Z",
    "status": "INACTIVE",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {}
}
Previous
Create a new program
Next
Clients API
Built with