Providing information related to a customer identity stored the account data bound to the customer's phone number.

client.knowyourcustomerfillIn.create(, ?): KnowyourcustomerfillInCreateResponse { address, birthdate, cityOfBirth, 22 more }

POST/knowyourcustomerfill-in/fill-in

Providing information related to a customer identity stored the account data bound to the customer’s phone number.

ParametersExpand Collapse

params: KnowyourcustomerfillInCreateParams { phoneNumber, xCorrelator }

phoneNumber?: string

Body param: A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ’+’.

xCorrelator?: string

Header param: Correlation id for the different services

ReturnsExpand Collapse

KnowyourcustomerfillInCreateResponse { address, birthdate, cityOfBirth, 22 more }

address?: string

Complete address of the customer stored on the Operator’s system. For some countries, it is built following the usual concatenation of parameters in a country, but for other countries, this is not the case. For some countries, it can use streetName, streetNumber and/or houseNumberExtension. For example, in ESP, streetName+streetNumber; in NLD, it can be streetName+streetNumber or streetName+streetNumber+houseNumberExtension.

birthdate?: string

Birthdate of the customer, in ISO 8601 calendar date format (YYYY-MM-DD), stored on the Operator’s system.

formatdate

cityOfBirth?: string

City where the customer was born.

country?: string

Country of the customer’s address stored on the Operator’s system. Format ISO 3166-1 alpha-2.

countryOfBirth?: string

Country where the customer was born. Format ISO 3166-1 alpha-2.

email?: string

Email address of the customer in the RFC specified format (local-part@domain), stored on the Operator’s system.

formatemail

familyName?: string

Last name, family name, or surname of the customer stored on the Operator’s system.

familyNameAtBirth?: string

Last/family/sur- name at birth of the customer stored on the Operator’s system.

gender?: "MALE" | "FEMALE" | "OTHER"

Gender of the customer stored on the Operator’s system (Male/Female/Other).

One of the following:

"MALE"

"FEMALE"

"OTHER"

givenName?: string

First/given name or compound first/given name of the customer on the Operator’s system.

houseNumberExtension?: string

House number extension of the customer stored on the Operator’s system. Specific identifier of the house needed depending on the property type. For example, number of apartment in an apartment building.

idDocument?: string

Id number associated to the id_document of the customer stored on the Operator’s system.

idDocumentExpiryDate?: string

Expiration date of the identity document (ISO 8601).

formatdate

idDocumentType?: "passport" | "national_id_card" | "residence_permit" | 4 more

Type of the official identity document provided.

One of the following:

"passport"

"national_id_card"

"residence_permit"

"diplomatic_id"

"driver_licence"

"social_security_id"

"other"

locality?: string

Locality of the customer’s address, stored on the Operator’s system.

middleNames?: string

Middle name/s of the customer stored on the Operator’s system.

name?: string

Complete name of the customer stored on the Operator’s system. It is usually composed of first/given name and last/family/sur- name in a country. Depending on the country, the order of first/give name and last/family/sur- name varies, and middle name could be included. It can use givenName, middleNames, familyName and/or familyNameAtBirth. For example, in ESP, name+familyName; in NLD, it can be name+middleNames+familyName or name+middleNames+familyNameAtBirth, etc.

nameKanaHankaku?: string

Complete name of the customer in Hankaku-Kana format (reading of name) for Japan, stored on the Operator’s system.

nameKanaZenkaku?: string

Complete name of the customer in Zenkaku-Kana format (reading of name) for Japan, stored on the Operator’s system.

nationality?: string

ISO 3166-1 alpha-2 code of the customer’s nationality. In the case a customer has more than one nationality, it is supposed to be the nationality related to the ID document provided in the match request.

phoneNumber?: string

A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ’+’.

postalCode?: string

The postal code or Zip code of the customer’s address, stored on the Operator’s system.

region?: string

Region/prefecture of the customer’s address, stored on the Operator’s system.

streetName?: string

Name of the street of the customer’s address on the Operator’s system. It should not include the type of the street.

streetNumber?: string

The street number of the customer’s address on the Operator’s system. Number identifying a specific property on the ‘streetName’.

Providing information related to a customer identity stored the account data bound to the customer's phone number.

import Camara from 'camara-sdk';

const client = new Camara({
  bearerToken: process.env['CAMARA_BEARER_TOKEN'], // This is the default and can be omitted
});

const knowyourcustomerfillIn = await client.knowyourcustomerfillIn.create({
  phoneNumber: '+34629255833',
});

console.log(knowyourcustomerfillIn.idDocument);

{
  "phoneNumber": "+34629255833",
  "idDocument": "66666666q",
  "idDocumentType": "passport",
  "idDocumentExpiryDate": "2027-07-12",
  "name": "Federica Sanchez Arjona",
  "givenName": "Federica",
  "familyName": "Sanchez Arjona",
  "nameKanaHankaku": "federica",
  "nameKanaZenkaku": "Ｆｅｄｅｒｉｃａ",
  "middleNames": "Sanchez",
  "familyNameAtBirth": "YYYY",
  "address": "Tokyo-to Chiyoda-ku Iidabashi 3-10-10",
  "streetName": "Nicolas Salmeron",
  "streetNumber": "4",
  "postalCode": "1028460",
  "region": "Tokyo",
  "locality": "ZZZZ",
  "country": "JP",
  "houseNumberExtension": "36",
  "birthdate": "1978-08-22",
  "email": "abc@example.com",
  "gender": "MALE",
  "cityOfBirth": "Madrid",
  "countryOfBirth": "ES",
  "nationality": "ES"
}

{
  "status": 400,
  "code": "INVALID_ARGUMENT",
  "message": "Client specified an invalid argument, request body or query param."
}

{
  "status": 401,
  "code": "UNAUTHENTICATED",
  "message": "Request not authenticated due to missing, invalid, or expired credentials. A new authentication is required."
}

{
  "status": 403,
  "code": "PERMISSION_DENIED",
  "message": "Client does not have sufficient permissions to perform this action."
}

{
  "status": 404,
  "code": "IDENTIFIER_NOT_FOUND",
  "message": "The phone number provided is not associated with a customer account"
}

{
  "status": 422,
  "code": "SERVICE_NOT_APPLICABLE",
  "message": "The service is not applicable for the provided phone number"
}

{
  "status": 422,
  "code": "MISSING_IDENTIFIER",
  "message": "No phone number has been provided"
}

{
  "status": 422,
  "code": "UNNECESSARY_IDENTIFIER",
  "message": "An explicit phone number has been provided when one is already associated with the access token"
}

Returns Examples

{
  "phoneNumber": "+34629255833",
  "idDocument": "66666666q",
  "idDocumentType": "passport",
  "idDocumentExpiryDate": "2027-07-12",
  "name": "Federica Sanchez Arjona",
  "givenName": "Federica",
  "familyName": "Sanchez Arjona",
  "nameKanaHankaku": "federica",
  "nameKanaZenkaku": "Ｆｅｄｅｒｉｃａ",
  "middleNames": "Sanchez",
  "familyNameAtBirth": "YYYY",
  "address": "Tokyo-to Chiyoda-ku Iidabashi 3-10-10",
  "streetName": "Nicolas Salmeron",
  "streetNumber": "4",
  "postalCode": "1028460",
  "region": "Tokyo",
  "locality": "ZZZZ",
  "country": "JP",
  "houseNumberExtension": "36",
  "birthdate": "1978-08-22",
  "email": "abc@example.com",
  "gender": "MALE",
  "cityOfBirth": "Madrid",
  "countryOfBirth": "ES",
  "nationality": "ES"
}

{
  "status": 400,
  "code": "INVALID_ARGUMENT",
  "message": "Client specified an invalid argument, request body or query param."
}

{
  "status": 401,
  "code": "UNAUTHENTICATED",
  "message": "Request not authenticated due to missing, invalid, or expired credentials. A new authentication is required."
}

{
  "status": 403,
  "code": "PERMISSION_DENIED",
  "message": "Client does not have sufficient permissions to perform this action."
}

{
  "status": 404,
  "code": "IDENTIFIER_NOT_FOUND",
  "message": "The phone number provided is not associated with a customer account"
}

{
  "status": 422,
  "code": "SERVICE_NOT_APPLICABLE",
  "message": "The service is not applicable for the provided phone number"
}

{
  "status": 422,
  "code": "MISSING_IDENTIFIER",
  "message": "No phone number has been provided"
}

{
  "status": 422,
  "code": "UNNECESSARY_IDENTIFIER",
  "message": "An explicit phone number has been provided when one is already associated with the access token"
}