Create a cardholder
Create a cardholder
Authorization
authorization
AuthorizationBearer <token>
In: header
Header Parameters
x-idempotency-key?string
Idempotency key in UUID v4 format
Format
uuidExample
"f30f1d0b-795f-49f5-80dc-41a7bffccfde"Request Body
application/json
Attributes to create a cardholder
addressAddress
Address schema
birthdatestring
Cardholder birthdate
Format
dateExample
"1941-09-09"documentobject
Person document
emailstring
Match
^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+){1,2}$Format
emailExample
"someone@gmail.com"first_namestring
String field
Length
2 <= length <= 64Example
"Dennis"last_namestring
String field
Length
2 <= length <= 64Example
"Alistair"middle_name?string|null
String field
Length
2 <= length <= 64Example
"Mac"nationalitystring
Country code ISO 3166-1 alpha-2
Match
^[A-Z]{2}$Example
"CO"phone_numberstring
Phone number
Match
^\+[1-9]\d{1,14}$Example
"+573000000000"second_last_name?string|null
String field
Length
2 <= length <= 64Example
"Ritchie"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.cert.monoban.co/v1/cards/cardholders" \ -H "Content-Type: application/json" \ -d '{ "address": { "city": "Chapinero", "country": "CO", "line_1": "Calle 97 # 15-24", "state": "Bogota D.C", "zip_code": "110221" }, "birthdate": "1941-09-09", "document": { "number": "1023711432", "type": "CC" }, "email": "someone@gmail.com", "first_name": "Dennis", "last_name": "Alistair", "nationality": "CO", "phone_number": "+573000000000" }'{
"address": {
"city": "Chapinero",
"country": "CO",
"extra": "Location near the southeast corner in front of the ABC mall. deliver to the security guard pedro pruebas",
"line_1": "Calle 97 # 15-24",
"line_2": "Apto. 208",
"state": "Bogota D.C",
"zip_code": "110221"
},
"birthdate": "1941-09-09",
"document": {
"country_code": "CO",
"number": "1023711432",
"person_type": "natural",
"type": "CC"
},
"email": "someone@gmail.com",
"first_name": "Dennis",
"id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"last_name": "Alistair",
"middle_name": "Mac",
"nationality": "CO",
"phone_number": "+573000000000",
"second_last_name": "Ritchie"
}{
"address": {
"city": "Chapinero",
"country": "CO",
"extra": "Location near the southeast corner in front of the ABC mall. deliver to the security guard pedro pruebas",
"line_1": "Calle 97 # 15-24",
"line_2": "Apto. 208",
"state": "Bogota D.C",
"zip_code": "110221"
},
"birthdate": "1941-09-09",
"document": {
"country_code": "CO",
"number": "1023711432",
"person_type": "natural",
"type": "CC"
},
"email": "someone@gmail.com",
"first_name": "Dennis",
"id": "carh_5tgliBmzjZ6mpQPRbQjfKj",
"last_name": "Alistair",
"middle_name": "Mac",
"nationality": "CO",
"phone_number": "+573000000000",
"second_last_name": "Ritchie"
}{
"code": "400 Bad Request",
"errors": [
{
"error_code": "validation_error",
"message": "Generic changeset errors",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Malformed request"
}{
"code": "401 Unauthorized",
"errors": [
{
"error_code": "expired_token",
"message": "The token is expired, inactive, or doesn't exist.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Authorization header is missing or invalid."
}{
"code": "403 Forbidden",
"errors": [
{
"error_code": "not_authorized",
"message": "Not authorized to have access to this resource.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Not authorized to have access to this resource"
}{
"code": "422 Unprocessable Entity",
"errors": [
{
"error_code": "missing_field",
"message": "The field is missing on the request body or parameters.",
"path": "#/path/to/field",
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Validation errors"
}