Skip to main content

Get business account data

Method#

/business/profile#

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/business/profile?phone={phone}

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

This method is responsible of returning the contact's business acount data


Attributes#

Required#

AttributesTypeDescription
phonestringBusiness account's phone number in the format DDI DDD NUMERS Ex: 551199999999. IMPORTANT only send numbers without formatting or a mask

Optionals#

AttributesTypeDescription

Request Params#

URL example#

Métodos

Método

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/business/profile?phone=5511999999999

Query params#

keyvaluedescription
phone5511999999999Business account's phone number in the format DDI DDD NUMERS Ex: 551199999999. IMPORTANT only send numbers without formatting or a mask

Response#

200#

AttributesTypeDescription
descriptionstringCompany's description
addressstringCompany's address
emailstringCompany's email
websitesarray stringCompany's webites
categoriesarray stringCategories data
businessHoursarray stringBusiness hours data
hasCoverPhotobooleanIf company has cover photo

Array String (categories)

AttributesTypeDescription
displayNamestringCategory name
labelstringCategory label
idstringCategory id

Array String (businessHours)

AttributesTypeDescription
timezonesstringTimezone
daysarray stringOperating data for the days
modestringOperating type

Array String (days)

AttributesTypeDescription
dayOfWeekstringDay of the week
openTimestringOpening time
closeTimestringClosing time

Example

{
"description": "Z API - Asas para sua imaginação",
"address": "Maringá",
"email": "zapi@example.com",
"websites": [
"https://www.z-api.io"
],
"categories": [
{
"displayName": "Outras empresas",
"label": "OTHER_COMPANIES",
"id": "629412378414563"
}
],
"businessHours": {
"timezone": "America/Sao_Paulo",
"days": [
{
"dayOfWeek": "MONDAY",
"openTime": "08:00",
"closeTime": "18:00"
},
{
"dayOfWeek": "TUESDAY",
"openTime": "08:00",
"closeTime": "18:00"
},
{
"dayOfWeek": "WEDNESDAY",
"openTime": "08:00",
"closeTime": "18:00"
},
{
"dayOfWeek": "THURSDAY",
"openTime": "08:00",
"closeTime": "18:00"
},
{
"dayOfWeek": "FRIDAY",
"openTime": "08:00",
"closeTime": "18:00"
}
],
"mode": "specificHours"
},
"hasCoverPhoto": false
}

405#

In this case certify that you are sending the correct specification of the method. This means, verify if you sent a POST or GET as specified at the beginning of this topic.

415#

In case you receive 415 error, make sure to add the “Content-Type” of the object you are sending in the request headers, mostly “application/json”