Skip to main content
POST
/
business
/
cardholders
Create a cardholder
curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/cardholders \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "dateOfBirth": "2023-12-25",
  "address1": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zipcode": "<string>",
  "country": "NG",
  "idType": "PASSPORT",
  "idNumber": "<string>",
  "bvn": "<string>",
  "idDocumentFrontUrl": "<string>"
}
'
{ "data": { "customerId": "NCUS9953596C2B7F45", "firstName": "<string>", "lastName": "<string>", "email": "<string>", "phone": "<string>", "country": "<string>", "status": "<string>", "activeCardCount": 123, "createdAt": "2023-11-07T05:31:56Z" }, "error": { "message": "<string>", "param": "<string>" }, "meta": { "request_id": "<string>", "pagination": { "page": 123, "page_size": 123, "total": 123, "has_more": true } } }

Authorizations

​
X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json
​
firstName
string
required
​
lastName
string
required
​
email
string | null
​
phone
string | null
​
dateOfBirth
string<date> | null
​
address1
string | null
​
city
string | null
​
state
string | null
​
zipcode
string | null
​
country
string | null
Example:

"NG"

​
idType
string | null
Example:

"PASSPORT"

​
idNumber
string | null
​
bvn
string | null
​
idDocumentFrontUrl
string | null

Response

Cardholder

Canonical response envelope for the public surface. data on success, error on failure.

​
data
object
required

Endpoint payload on success (object or array); null on failure.

​
error
object
required
​
meta
object
required