The Customers resource in our API represents a crucial component of
our service, primarily designed to manage customer information effectively.
This resource is essential for businesses seeking to build a robust and
user-friendly platform. By offering a comprehensive overview of customer
data, it enables seamless integration of customer management into your
application. Payiano helps you manage customers
efficiently. You can set up various customers and attach them for
Payment Links, subscriptions, and one-time payments through Checkout.
Importance of Handling Customer Data
Personalized Experience:
Understanding customer preferences and history allows for tailored experiences, increasing
customer satisfaction and loyalty.
Efficiency and Accuracy:
Accurate customer data ensures smooth transactions, reduces errors, and enhances the
efficiency of operations, from billing to customer support.
Data Analysis:
Well-organized customer data can be a goldmine for insights, helping in strategic
decision-making and targeted marketing.
Multiple Addresses:
One of the key features of the Customers resource is the ability to associate multiple
shipping and billing addresses with a single customer profile. This flexibility is
particularly beneficial for customers who require different addresses for various
purposes, such as separate billing and shipping addresses, or for those who
frequently change their shipping locations.
GET/customers
Sandbox: https://api.payiano.dev/v1/customers
Live: https://api.payiano.com/v1/customers
Security
Authorization header with access token is required to access this endpoint: Bearer ACCESS-TOKEN
Your access token should be associated to this permission customers_view
Request
Request body schema:
application/json
Query parameters:
page
page
Type: integer|null
Default: 1
The page number to be retrieved, for the list of customers. So, a combination of page=1 and per_page=25 returns the first 25 customers. A combination of page=2 and per_page=25 returns the next 25 customers.
per_page
per_page
Type: integer|null
Default: 25
Possible values: [1 ... 200]
The maximum number of customers to return in the response.
A list of additional customer relations to return, if available. Feel free
to send the relations you would like to return with every item. See Including Resources to better understand how this is working.
Response
200
Response schema:
application/json
Response body:
total_pages
total_pages
Type: integer
The total number of pages that are available for the customers search criteria.
current_page
current_page
Type: integer
The current pagination page.
per_page
per_page
Type: integer
The amount of customers items return per page.
total_items
total_items
Type: integer
The total number of customers that match the search criteria.
items
items
Type: array_of_objects
The list of customers that match the search criteria.
id
id
Type: ulid
Length: 26
The unique ID assigned to each customer which is generated
by our system using the ULID format. Each ID is
precisely 26 characters long, ensuring a unique and consistent
identifier for every customer. This ULID is
automatically created by our system and is used to uniquely identify
and track each customer in our database.
name
name
Type: string
Min: 2
Max: 255
This is the fundamental attribute representing the customer's full legal or preferred name.
It's used in all forms of communication and identification. It's crucial for personalization
and ensures that all correspondences and documents are correctly addressed.
email
email
Type: string|null
Min: 5
Max: 255
The email address is a key point of contact for digital communication. It's used for sending
transactional emails, marketing material and support communications.
billing_emails
billing_emails
Type: array_of_strings
Max: 20
In addition to the primary email, customers might have separate email addresses specifically for
billing purposes. This field can store multiple emails, ensuring that all billing-related documents
reach the appropriate contacts, which is especially useful in business settings.
cc_emails
cc_emails
Type: array_of_strings
Max: 20
These are carbon copy email addresses where copies of communications are sent. This is particularly
useful in a business context where multiple parties, like account managers or financial departments,
need to be kept in the loop.
shipping_address_as_billing_address
shipping_address_as_billing_address
Type: boolean
Default: true
Another boolean attribute indicating whether the customer's shipping address is identical to their
billing address. This simplifies the process for customers who use the same address for both purposes
and streamlines data entry and management.
billing_email_as_customer_email
billing_email_as_customer_email
Type: boolean
Default: true
This attribute indicates whether the customer's primary email address, which is used for general
communication and account management, is the same as the email address used specifically for billing
purposes.
phone_number
phone_number
Type: string|null
This attribute stores the customer's telephone or mobile number. It's essential for direct contact,
SMS notifications, and can also be used in cases where email communication is insufficient or inappropriate.
type
type
Type: enum|null
Possible values:
["INDIVIDUAL","BUSINESS"]
This attribute is used to differentiates between types of customers, such as individual consumers,
business clients, or other classifications. The type can influence how the profile is managed and
what kind of communication is sent.
gender
gender
Type: enum|null
Possible values:
["MALE","FEMALE","NON_BINARY"]
Recording the customer's gender can help in creating more personalized marketing strategies and customer
interactions. It's useful for demographic segmentation and can be leveraged to tailor products, services,
and communication to better align with the customer's preferences.
country_code
country_code
Type: string|null
Specify the unique two-letter country code ( e.g EG, SA or AE )
corresponding to the country where your customer is based. This code is part of the standard
international country codes set by the ISO .
reference_id
reference_id
Type: string|null
Max: 50
It's a unique identifier assigned to each customer. It's
primary role is to distinguish one customer from another, ensuring
that each customer can be individually tracked and managed without
any confusion. Please notice that duplicate values are not allowed
and it's allowed to use alpha dash only [A-Za-z0-9-_]. The reference_id
value is used to Identify Resource when you consume any customer endpoint with sending identify_by
query parameter with value reference_id.
is_active
is_active
Type: boolean
Default: true
This value indicates whether the customer is active or not. This flag can be used
to control the customer's availability in runtime environments or listings without
deleting or removing the customer from records. A true value means the customer
is active and functioning, while a false value implies that the customer is
deactivated or not in use.
description
description
Type: string|null
Max: 10000
This free-form text field allows for adding additional notes or details about the customer. It can include
information like customer preferences, special instructions, past interactions, or any other relevant data
that doesn't fit into more structured fields.
tags
tags
Type: array_of_objects
Max: 20
The list of customer tags objects.
id
id
Type: ulid
Length: 26
The unique ID assigned to each customer tag which is generated
by our system using the ULID format. Each ID is
precisely 26 characters long, ensuring a unique and consistent
identifier for every customer tag. This ULID is
automatically created by our system and is used to uniquely identify
and track each customer tag in our database.
name
name
Type: string
Min: 1
Max: 100
This attribute serves as the identifier or label for the group. It's a concise and clear title
that represents the essence of the group. For instance, a name could be 'Frequent Buyers' or
'Newsletter Subscribers'. This attribute should be chosen to reflect the common characteristic
or purpose that links the customers in this tag, making it easy to identify and reference the
group at a glance. Please notice that duplicate values are not allowed and it's allowed
to use alpha dash only [A-Za-z0-9-_ ].
is_active
is_active
Type: boolean
Default: true
This value indicates whether the customer tag is active or not. This flag can be used
to control the customer tag's availability in runtime environments or listings without
deleting or removing the customer tag from records. A true value means the customer tag
is active and functioning, while a false value implies that the customer tag is
deactivated or not in use.
reference_id
reference_id
Type: string|null
Max: 50
It's a unique identifier assigned to each customer tag. It's
primary role is to distinguish one customer tag from another, ensuring
that each customer tag can be individually tracked and managed without
any confusion. Please notice that duplicate values are not allowed
and it's allowed to use alpha dash only [A-Za-z0-9-_]. The reference_id
value is used to Identify Resource when you consume any customer tag endpoint with sending identify_by
query parameter with value reference_id.
description
description
Type: string|null
Max: 10000
This attribute provides more detailed information about the customer tag. It's where you can
explain the purpose or characteristics of the group in more depth. For example, for a tag named
'Frequent Buyers', the description might elaborate on criteria like “Customers who make purchases
more than twice a month.” This attribute is particularly useful for understanding the context and
nuances of the customer group, guiding how you interact with and cater to this segment.
metadata
metadata
Type: object|null
The customer tag metadata model details. Metadata serves as a tool
for keeping extra, organized details about a resource. For example,
you can use it to store a user's preferences like prefered color,
notes or any other data that aids in personalizing services, improving
customer relations, or optimizing internal workflows. This information
isn't utilized by Payiano – meaning it's not
involved in authorizing or declining transactions and remains invisible
to your users. Its value is entirely private for your internal
use, and we ensure it remains confidential, not shared with any
external parties.
info
info
Type: array_of_objects
Max: 50
This array consists of objects, each containing a key and a value.
These pairs of key-value are structured in a way that's more suitable
for programmatic access. You can add up to 50 objects.
key
key
Type: string
Min: 1
Max: 50
It's a unique identifier to avoid confusion or data overlap.
The keys serve as identifiers for the corresponding values, making
it easier to retrieve specific pieces of information as needed.
value
value
Type: string
Min: 1
Max: 255
The value is the actual data associated with that key. It could be
a simple string, a number, a URL, or any other data format that
conveys the necessary information.
list
list
Type: array_of_strings
Max: 50
The list attribute is particularly useful for scenarios where
the data needs to be presented in a straightforward, unstructured
format. It's ideal for quick overviews, simple data logging, or
when the information does not require the more complex organization
that nested JSON objects provide. Please
notice that duplicate values are not allowed, you can add up
to 50 item and the max list item length is 255
characters.
is_deleted
is_deleted
Type: boolean
Default: false
This value indicates whether the customer tag is deleted or not. This flag can be used to
control the customer tag's availability in runtime without actual deleting or removing the
customer tag from records. A true value means the customer tag is deleted, while a false
value implies that the customer tag is not deleted and functioning.
created_at
created_at
Type: datetime
The created datetime of the customer tag.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
updated_at
updated_at
Type: datetime
The updated datetime of the customer tag.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
deleted_at
deleted_at
Type: datetime|null
The deleted datetime of the customer tag.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
metadata
metadata
Type: object|null
The customer metadata model details. Metadata serves as a tool
for keeping extra, organized details about a resource. For example,
you can use it to store a user's preferences like prefered color,
notes or any other data that aids in personalizing services, improving
customer relations, or optimizing internal workflows. This information
isn't utilized by Payiano – meaning it's not
involved in authorizing or declining transactions and remains invisible
to your users. Its value is entirely private for your internal
use, and we ensure it remains confidential, not shared with any
external parties.
info
info
Type: array_of_objects
Max: 50
This array consists of objects, each containing a key and a value.
These pairs of key-value are structured in a way that's more suitable
for programmatic access. You can add up to 50 objects.
key
key
Type: string
Min: 1
Max: 50
It's a unique identifier to avoid confusion or data overlap.
The keys serve as identifiers for the corresponding values, making
it easier to retrieve specific pieces of information as needed.
value
value
Type: string
Min: 1
Max: 255
The value is the actual data associated with that key. It could be
a simple string, a number, a URL, or any other data format that
conveys the necessary information.
list
list
Type: array_of_strings
Max: 50
The list attribute is particularly useful for scenarios where
the data needs to be presented in a straightforward, unstructured
format. It's ideal for quick overviews, simple data logging, or
when the information does not require the more complex organization
that nested JSON objects provide. Please
notice that duplicate values are not allowed, you can add up
to 50 item and the max list item length is 255
characters.
billing_address
billing_address
Type: object|null
The customer default billing address model details.
id
id
Type: ulid
Length: 26
The unique ID assigned to each customer address which is generated
by our system using the ULID format. Each ID is
precisely 26 characters long, ensuring a unique and consistent
identifier for every customer address. This ULID is
automatically created by our system and is used to uniquely identify
and track each customer address in our database.
country_code
country_code
Type: string
Specify the unique two-letter country code ( e.g EG, SA or AE )
corresponding to the country where customer is located. This code is part of the standard
international country codes set by the ISO .
type
type
Type: enum
Possible values:
["BILLING_ADDRESS","SHIPPING_ADDRESS"]
This attribute is used to differentiates between types of customer addresses,
such as billing or shipping address.
is_default
is_default
Type: boolean
Default: false
This attribute specifies if the address is the default one selected
for the customer for billing or shipping purposes. It comes into
play when the user is directed to the checkout page or when an
order is being delivered to them.
reference_id
reference_id
Type: string|null
Max: 50
It's a unique identifier assigned to each customer address. It's
primary role is to distinguish one customer address from another, ensuring
that each customer address can be individually tracked and managed without
any confusion. Please notice that duplicate values are not allowed
and it's allowed to use alpha dash only [A-Za-z0-9-_]. The reference_id
value is used to Identify Resource when you consume any customer address endpoint with sending identify_by
query parameter with value reference_id.
line_one
line_one
Type: string|null
Min: 2
Max: 255
This attribute is the primary address line. This is where the first part of the
address is written, usually the house number and street name. It's where the mail
starts to find where you live or work.
line_two
line_two
Type: string|null
Min: 2
Max: 255
An optional secondary address line used for additional information like apartment,
suite, or building numbers that help refine the location for delivery services.
city
city
Type: string|null
Min: 2
Max: 50
This attribute specifies the city in which the address is located. It's essential
for routing mail and deliveries within the correct geographical area.
state
state
Type: string|null
Min: 2
Max: 50
The state or region attribute further narrows down the location, especially in
countries with large geographical areas divided into states, provinces, or regions.
zip_code
zip_code
Type: string|null
Min: 2
Max: 30
Also known as postal code in some regions, this numeric or alphanumeric code is
critical for sorting mail and determining delivery routes with precision.
phone_number
phone_number
Type: string|null
Max: 30
A primary contact number that can be a mobile or cellular number, providing a
direct line to the individual or entity associated with the address.
landline_number
landline_number
Type: string|null
Max: 30
An alternative to the mobile number, this is a fixed-line telephone number
associated with the location, useful for contact purposes where mobile signals
may be unreliable.
fax_number
fax_number
Type: string|null
Max: 30
Not used as much these days, but it's a number where you can receive documents
sent over a telephone line.
first_name
first_name
Type: string|null
Min: 2
Max: 50
The given name of the individual associated with the address, important for
personalizing communication and ensuring the correct recipient for mail or
services.
last_name
last_name
Type: string|null
Min: 2
Max: 50
The family or surname of the individual, completing the personal identification
and used in conjunction with the first name for full clarity on the recipient's
identity.
is_deleted
is_deleted
Type: boolean
Default: false
This value indicates whether the customer address is deleted or not. This flag can be used to
control the customer address's availability in runtime without actual deleting or removing the
customer address from records. A true value means the customer address is deleted, while a false
value implies that the customer address is not deleted and functioning.
location
location
Type: object|null
This attribute is used to offer a precise, geographical identification of a
place, which is crucial for various applications like mapping, navigation,
and location-based services.
lat
lat
Type: decimal
Min: -90
Max: 90
This stands for latitude. It's a way to tell exactly where the address is
on the Earth using GPS. It tells you how far north or south the place is.
lng
lng
Type: decimal
Min: -180
Max: 180
This is the longitude. Like latitude, but it tells you how far east or west
the place is. Together with latitude, it can pinpoint any location on the globe.
note
note
Type: string|null
Min: 2
Max: 255
This free-text field allows for additional information or special instructions
related to the address or delivery preferences to be included.
customer_id
customer_id
Type: ulid
This field is the key to associating each address
with the correct customer account, enhancing the personalization
and accuracy of the transaction process. It's not only enhances
transaction precision but also contributes significantly to
effective customer relationship management and data analysis.
country
country
Type: object
This attribute is used to offer a precise, geographical identification of a
place, which is crucial for various applications like mapping, navigation,
and location-based services.
code
code
Type: string
It implies the unique two-letter country code ( e.g EG, SA or AE )
corresponding to the country. This code is part of the standard international country
codes set by the ISO .
dial_code
dial_code
Type: string
The international dialing code for the country, such as +1 for the United States,
+44 for the United Kingdom or +20 for Egypt. This code is crucial for
making international telephone calls and can be used in applications that require user
phone number verification.
currency_code
currency_code
Type: string
This attribute describes the official currency used in the country, typically denoted
by its ISO currency code, such as USD for the United States Dollar,
EUR for the Euro or EGP for Egyptian Pound.
name
name
Type: string
The official name of the country in English. This is the commonly recognized name that
would be used in international contexts and is essential for any application that
references countries by name.
name_ar
name_ar
Type: string|null
The name of the country in Arabic. This attribute is particularly useful for applications
serving Arabic-speaking users, allowing for a localized experience by presenting country
names in the native script.
lang
lang
Type: string|null
This attribute represents the primary language spoken in the country. It's typically
expressed in ISO 639-1 format, a two-letter code identifying the language,
making it easier for applications to adapt content or interfaces according to the user's
region.
flag
flag
Type: string|null
A Unicode representation of the country's flag. Unlike an image URL, Unicode flags
are character codes that render as the country's flag emoji across compatible digital
platforms. This allows for easy integration of flags into text-based content and
interfaces without needing external images.
created_at
created_at
Type: datetime
The created datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
updated_at
updated_at
Type: datetime
The updated datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
deleted_at
deleted_at
Type: datetime|null
The deleted datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
shipping_address
shipping_address
Type: object|null
The customer default shipping address model details.
id
id
Type: ulid
Length: 26
The unique ID assigned to each customer address which is generated
by our system using the ULID format. Each ID is
precisely 26 characters long, ensuring a unique and consistent
identifier for every customer address. This ULID is
automatically created by our system and is used to uniquely identify
and track each customer address in our database.
country_code
country_code
Type: string
Specify the unique two-letter country code ( e.g EG, SA or AE )
corresponding to the country where customer is located. This code is part of the standard
international country codes set by the ISO .
type
type
Type: enum
Possible values:
["BILLING_ADDRESS","SHIPPING_ADDRESS"]
This attribute is used to differentiates between types of customer addresses,
such as billing or shipping address.
is_default
is_default
Type: boolean
Default: false
This attribute specifies if the address is the default one selected
for the customer for billing or shipping purposes. It comes into
play when the user is directed to the checkout page or when an
order is being delivered to them.
reference_id
reference_id
Type: string|null
Max: 50
It's a unique identifier assigned to each customer address. It's
primary role is to distinguish one customer address from another, ensuring
that each customer address can be individually tracked and managed without
any confusion. Please notice that duplicate values are not allowed
and it's allowed to use alpha dash only [A-Za-z0-9-_]. The reference_id
value is used to Identify Resource when you consume any customer address endpoint with sending identify_by
query parameter with value reference_id.
line_one
line_one
Type: string|null
Min: 2
Max: 255
This attribute is the primary address line. This is where the first part of the
address is written, usually the house number and street name. It's where the mail
starts to find where you live or work.
line_two
line_two
Type: string|null
Min: 2
Max: 255
An optional secondary address line used for additional information like apartment,
suite, or building numbers that help refine the location for delivery services.
city
city
Type: string|null
Min: 2
Max: 50
This attribute specifies the city in which the address is located. It's essential
for routing mail and deliveries within the correct geographical area.
state
state
Type: string|null
Min: 2
Max: 50
The state or region attribute further narrows down the location, especially in
countries with large geographical areas divided into states, provinces, or regions.
zip_code
zip_code
Type: string|null
Min: 2
Max: 30
Also known as postal code in some regions, this numeric or alphanumeric code is
critical for sorting mail and determining delivery routes with precision.
phone_number
phone_number
Type: string|null
Max: 30
A primary contact number that can be a mobile or cellular number, providing a
direct line to the individual or entity associated with the address.
landline_number
landline_number
Type: string|null
Max: 30
An alternative to the mobile number, this is a fixed-line telephone number
associated with the location, useful for contact purposes where mobile signals
may be unreliable.
fax_number
fax_number
Type: string|null
Max: 30
Not used as much these days, but it's a number where you can receive documents
sent over a telephone line.
first_name
first_name
Type: string|null
Min: 2
Max: 50
The given name of the individual associated with the address, important for
personalizing communication and ensuring the correct recipient for mail or
services.
last_name
last_name
Type: string|null
Min: 2
Max: 50
The family or surname of the individual, completing the personal identification
and used in conjunction with the first name for full clarity on the recipient's
identity.
is_deleted
is_deleted
Type: boolean
Default: false
This value indicates whether the customer address is deleted or not. This flag can be used to
control the customer address's availability in runtime without actual deleting or removing the
customer address from records. A true value means the customer address is deleted, while a false
value implies that the customer address is not deleted and functioning.
location
location
Type: object|null
This attribute is used to offer a precise, geographical identification of a
place, which is crucial for various applications like mapping, navigation,
and location-based services.
lat
lat
Type: decimal
Min: -90
Max: 90
This stands for latitude. It's a way to tell exactly where the address is
on the Earth using GPS. It tells you how far north or south the place is.
lng
lng
Type: decimal
Min: -180
Max: 180
This is the longitude. Like latitude, but it tells you how far east or west
the place is. Together with latitude, it can pinpoint any location on the globe.
note
note
Type: string|null
Min: 2
Max: 255
This free-text field allows for additional information or special instructions
related to the address or delivery preferences to be included.
customer_id
customer_id
Type: ulid
This field is the key to associating each address
with the correct customer account, enhancing the personalization
and accuracy of the transaction process. It's not only enhances
transaction precision but also contributes significantly to
effective customer relationship management and data analysis.
country
country
Type: object
This attribute is used to offer a precise, geographical identification of a
place, which is crucial for various applications like mapping, navigation,
and location-based services.
code
code
Type: string
It implies the unique two-letter country code ( e.g EG, SA or AE )
corresponding to the country. This code is part of the standard international country
codes set by the ISO .
dial_code
dial_code
Type: string
The international dialing code for the country, such as +1 for the United States,
+44 for the United Kingdom or +20 for Egypt. This code is crucial for
making international telephone calls and can be used in applications that require user
phone number verification.
currency_code
currency_code
Type: string
This attribute describes the official currency used in the country, typically denoted
by its ISO currency code, such as USD for the United States Dollar,
EUR for the Euro or EGP for Egyptian Pound.
name
name
Type: string
The official name of the country in English. This is the commonly recognized name that
would be used in international contexts and is essential for any application that
references countries by name.
name_ar
name_ar
Type: string|null
The name of the country in Arabic. This attribute is particularly useful for applications
serving Arabic-speaking users, allowing for a localized experience by presenting country
names in the native script.
lang
lang
Type: string|null
This attribute represents the primary language spoken in the country. It's typically
expressed in ISO 639-1 format, a two-letter code identifying the language,
making it easier for applications to adapt content or interfaces according to the user's
region.
flag
flag
Type: string|null
A Unicode representation of the country's flag. Unlike an image URL, Unicode flags
are character codes that render as the country's flag emoji across compatible digital
platforms. This allows for easy integration of flags into text-based content and
interfaces without needing external images.
created_at
created_at
Type: datetime
The created datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
updated_at
updated_at
Type: datetime
The updated datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
deleted_at
deleted_at
Type: datetime|null
The deleted datetime of the customer address.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
created_at
created_at
Type: datetime
The created datetime of the customer.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
updated_at
updated_at
Type: datetime
The updated datetime of the customer.
This attribute can be formatted as an ISO 8601
string or a UNIX timestamp in milliseconds,
depending on the preferred datetime format specified in the request header (e.g., 2024-08-04T14:22:01Z or
1722572118554). By default, the format is UNIX
timestamp in milliseconds.
Response sample:
1{2"per_page": 25,3"total_pages": 1,4"total_items": 1,5"current_page": 1,6"items": [7{8"id": "01hqjp3f48879znt9v4dysrk2r",9"name": "Mohsen Ali",10"email": "mohsen@gawaab.com",11"billing_emails": [12"shady.abbas@gawaab.com",13"diab.maged@gawaab.com"14],15"cc_emails": [16"ramy.tarek@gawaab.com",17"dina.mourad@gawaab.com"18],19"shipping_address_as_billing_address": true,20"billing_email_as_customer_email": true,21"phone_number": "+201000333000",22"type": "INDIVIDUAL",23"gender": "MALE",24"country_code": "EG",25"reference_id": "7193edd2-7574-3b76-9103-e0e37580129b",26"is_active": true,27"description": "Business development head at Gawaab",28"tags": [29{30"id": "01hqjp31wcww3jhnagehc16r04",31"name": "Frequent Buyers",32"is_active": true,33"reference_id": "7193edd2-7574-3b76-9103-e0e37580129b",34"description": "Customers who make purchases more than twice a month.",35"metadata": {36"info": [37{38"key": "Company name",39"value": "Pyngy"40}41],42"list": [43"Cairo, Nasr City, 7th District, Building 12 floor 5"44]45},46"is_deleted": false,47"created_at": "1722572118554",48"updated_at": "1722572118554",49"deleted_at": null50}51],52"metadata": {53"info": [54{55"key": "Company name",56"value": "Pyngy"57}58],59"list": [60"Cairo, Nasr City, 7th District, Building 12 floor 5"61]62},63"billing_address": {64"id": "01ht3tph1szfa5b02qsay22hk1",65"country_code": "EG",66"type": "BILLING_ADDRESS",67"is_default": true,68"reference_id": "96bf2bca-61c0-3eba-bc85-bfae3bcfd85f",69"line_one": "7th Makram Ebid, Nasr City",70"line_two": "Building 174, apartment 12",71"city": "Cairo",72"state": "Nasr City",73"zip_code": "11321",74"phone_number": "+201000333000",75"landline_number": "6546543213216",76"fax_number": "5456464646",77"first_name": "Mohsen",78"last_name": "Osama",79"is_deleted": false,80"location": {81"lat": 21.32,82"lng": 12.6383},84"note": null,85"customer_id": "01hqjp3f48879znt9v4dysrk2r",86"country": {87"code": "EG",88"dial_code": "+20",89"currency_code": "EGP",90"name": "Egypt",91"name_ar": "مصر",92"lang": "AR",93"flag": "🇪🇬"94},95"created_at": "1722572118554",96"updated_at": "1722572118554",97"deleted_at": null98},99"shipping_address": {100"id": "01ht3tph1szfa5b02qsay22hk1",101"country_code": "EG",102"type": "SHIPPING_ADDRESS",103"is_default": true,104"reference_id": "96bf2bca-61c0-3eba-bc85-bfae3bcfd85f",105"line_one": "7th Makram Ebid, Nasr City",106"line_two": "Building 174, apartment 12",107"city": "Cairo",108"state": "Nasr City",109"zip_code": "11321",110"phone_number": "+201000333000",111"landline_number": "6546543213216",112"fax_number": "5456464646",113"first_name": "Mohsen",114"last_name": "Osama",115"is_deleted": false,116"location": {117"lat": 21.32,118"lng": 12.63119},120"note": null,121"customer_id": "01hqjp3f48879znt9v4dysrk2r",122"country": {123"code": "EG",124"dial_code": "+20",125"currency_code": "EGP",126"name": "Egypt",127"name_ar": "مصر",128"lang": "AR",129"flag": "🇪🇬"130},131"created_at": "1722572118554",132"updated_at": "1722572118554",133"deleted_at": null134},135"created_at": "1722572118554",136"updated_at": "1722572118554"137}138]139}