7 Customers API: How to get an existing handle

This is a series of articles dedicated to managing customer objects via Openprovider API.

This is a second article in a series in which we are going to cover customer handle search. To get more information about our API in general, please use our documentation portal as your reference.

Searching for a handle
Entering Geo Fence iconUse endpoint path below. Base URL is determined by both the target environment and API version.

GET {base_url}/customer

Our API has two methods that can return information about an existing customer object. The first one that we are going to cover is a method which returns a list of customer objects matching a particular search criteria.

REQUEST VALUES

Name Type Description
handle_pattern string  
email_pattern string  
first_name_pattern string  
last_name_pattern string  
company_name_pattern string  
comment_pattern string  
with_additional_data boolean Accepted values ‘true’ or ‘false’ - default value ‘false’
limit integer default value: 100, maximum value: 1000
offset integer default value: 0

REQUEST EXAMPLE

curl -X GET \ 
'https://api.cte.openprovider.eu/v1beta/customers?handle_pattern=XX123456-XX&with_additional_data=true' \
-H 'Authorization: ,Bearer 2831a37fb8*******90b5aac822' \

RESPONSE EXAMPLE

RESPONSE VALUES

Name Type Description
handle varchar Customer unique identifier or handle
company_name    
vat    
name    
address    
phone    
fax    
email    
additional_data   if withAdditionalData = true
extension_additional_data   if withAdditionalData = true


Retrieving a handle

Once we know that a particular user handle exists, we can retrieve its data by calling Get Customer:

Entering Geo Fence iconUse endpoint path below. Base URL is determined by both the target environment and API version.

GET {base_url}/customer/{handle}

REQUEST VALUES

Name Type Description
handle string  
with_additional_data string Accepted values ‘true’ or ‘false’ - default value ‘false’

REQUEST EXAMPLE

curl -X GET \ 
'https://api.cte.openprovider.eu/v1beta/customers/XX123456-XX?with_additional_data=true' \
-H 'Authorization: ,Bearer 2831a37fb8*******90b5aac822' \

RESPONSE EXAMPLE

Was this article helpful?
Additional questions? Submit a request