Logo
Brex Developer API Documentation

Create card

POST {{baseUrl}}/v2/cards

Creates a new card. The spend_controls field is required when limit_type = CARD. The mailing_address field is required for physical cards and is the shipping address used to send the card; it is not the same as the billing and mailing address used for online purchases. The first 2 lines of this address must be under 60 characters long. Each user can only have up to 10 active physical cards.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Idempotency-Key
string (Required)
Content-Type
string




RESPONSES

status OK

{ "billing_address": { "line1": "sed dolore fugiat", "line2": "pariatur Duis", "city": "non ipsum sit", "state": "culpa", "country": "laboris dolore", "postal_code": "qui cillum", "phone_number": "esse " }, "card_name": "aliquip sit ut fugiat", "id": "consequat nisi magna ut", "last_four": "ad", "limit_type": "CARD", "owner": { "type": "USER", "user_id": "aute reprehenderit sint dolore" }, "status": { "value": "<Error: Could not resolve allOf schema" }, "card_type": { "value": "<Error: Could not resolve allOf schema" }, "spend_controls": { "spend_available": { "amount": 70542088, "currency": "fugiat in exercitation" }, "spend_limit": { "amount": -91404032, "currency": "laborum ea ullamco dolore" }, "spend_duration": { "value": "<Error: Could not resolve allOf schema" }, "reason": "anim", "lock_after_date": "1958-03-13" }, "mailing_address": { "line1": "officia do eiusmod labore", "line2": "amet", "city": "ull", "state": "dolore reprehenderit", "country": "incididunt esse minim et", "postal_code": "consequat magna enim", "phone_number": "dolore sunt" } }



Curl
curl -X POST 'https://platform.staging.brexapps.com/v2/cards' -H 'Idempotency-Key: $guid' -H 'Content-Type: application/json'

ENDPOINTS