> ## Documentation Index > Fetch the complete documentation index at: https://docs.y.uno/llms.txt > Use this file to discover all available pages before exploring further. # The Customer Object This object represents a customer who will make payments using your service. ## Attributes The unique identifier of the customer (MAX 64; MIN 36). Example: faa89e18-5a11-11ed-9b6a-0242ac120002 The unique identifier of the customer in the external merchant (MAX 255; MIN 1). Example: 50ca6f06-5a12-11ed-9b6a-0242ac120002 Customer´s registration date on the merchants platform (MAX 27; MIN 27 ISO 3166-1 ). Example: 2022-05-09T20:46:54.786342Z The customer's first name (MAX 255; MIN 1). Example: John The customer's last name (MAX 255; MIN 1). Example: Doe The customer's gender (MAX 2; MIN 1). Possible enum values: `M`, `F` or `NB` The customer's date of birth in the YYYY-MM-DD format (MAX 10; MIN 10). Example: 1990-02-28 The customer's e-mail (MAX 255; MIN 3). Example: [john.doe@email.com](mailto:john.doe@email.com) The customer's nationality (MAX 2; MIN 2; ISO 3166-1 ). Possible enum values: Check the Country reference. The customer's country (MAX 2; MIN 2; ISO 3166-1 ). Possible enum values: Check the Country reference. Specifies the customer's document object, including its number and type. The customer's document number (MAX 40; MIN 3). Example: 1093333333 The customer's document type (MAX 6; MIN 2). Possible enum values: Check the Country reference. Specifies the customer's phone number object. The country calling code of the customer's phone (MAX 3; MIN 1). Possible values: Check the Country reference . Example: 57 The customer's phone number, without the country code (MAX 32; MIN 1). Example: 3132450765 Specifies the customer's billing address object. The primary billing address line of the customer (MAX 255; MIN 3). Example: Calle 34 # 56 - 78 The secondary billing address line of the customer (MAX 255; MIN 3). Example: Apartamento 502, Torre I The city considered for the billing address (MAX 255; MIN 3). Example: Bogotá The country considered for the billing address (MAX 2; MIN 2; ISO 3166-1 ). Possible enum values: Check the Country reference. The state considered for the billing address (MAX 255; MIN 3; ISO 3166-2 ). Example: Cundinamarca The zipcode considered for the billing address (MAX 11; MIN 4). Example: 111111 The neighborhood of the address line of the customer(MAX 255; MIN 2) Example: Barrio 11 Specifies the customer's shipping address object. The primary shipping address line of the customer (MAX 255; MIN 3). Example: Calle 34 # 56 - 78 The secondary shipping address line of the customer (MAX 255; MIN 3). Example: Apartamento 502, Torre I The city considered for the shipping address (MAX 255; MIN 3). Example: Bogotá The country considered for the shipping address (MAX 2; MIN 2; ISO 3166-1 ). Possible enum values: Check the Country reference. The state considered for the shipping address (MAX 255; MIN 3; ISO 3166-2 ). Example: Cundinamarca The zipcode considered for the shipping address (MAX 10; MIN 5). Example: 111111 The neighborhood of the address line of the customer(MAX 255; MIN 2) Example: Barrio 11 Specifies a list of custom key–value pairs associated with the customer (for internal references, segmentation, or workflow tags). You can add up to 50 metadata objects. Specifies a metadata key and the respective value. Use to attach merchant-defined context (for example: `crm_id`, `segment`). Avoid sending sensitive or personal data. Specifies one metadata key. Example: age Specifies the value for the defined metadata key. Example: 28 Customer creation date and time (MAX 27; MIN 27; ISO 8601 ). Example: 2022-05-09T20:46:54.786342Z Last customer update date and time (MAX 27; MIN 27; ISO 8601 ). Example: 2022-05-09T20:46:54.786342Z