Add Billing Details

POST

/v1/billings

Add billing details for the authenticated user.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Example

{
    "cardNumber": "4111111111111111",
    "expiryMonth": "12",
    "expiryYear": "2028",
    "cvv": "123",
    "billingAddress": "123 Main St, New York, NY 10001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/billings' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "cardNumber": "4111111111111111",
    "expiryMonth": "12",
    "expiryYear": "2028",
    "cvv": "123",
    "billingAddress": "123 Main St, New York, NY 10001"
}'

Responses

🟢201

application/json

Billing details added successfully

Bodyapplication/json

Example

{
    "status": 201,
    "message": "Billing details added successfully",
    "data": {
        "id": "bill_12345",
        "last4": "1111",
        "brand": "Visa",
        "expiryMonth": "12",
        "expiryYear": "2028",
        "createdAt": "2025-10-04T15:00:00Z"
    }
}

🟠400

🟠401

Update Workspace

Get Wallet Balance