v1

latestSwagger 2.02026-08-065854114.9 KB
people

List and search for people.

get/people

Query parameters

pageinteger

Page of results to fetch.

per_pageinteger

Number of results to return per page.

namestring

Name prefix.

categoryinteger

Category ID.

leadOrigininteger

Lead origin ID.

productsinteger[]

Array of product IDS.

authorinteger

Author user ID.

userOwnerinteger

Owner user ID.

rolestring

Role prefix.

cpfstring

Document number (CPF) prefix.

organizationinteger

Organization ID.

state'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO'

Address state abbreviation.

cityNamestring

City name prefix.

districtstring

District name prefix.

emailstring

Contact email prefix.

work_phonestring

Work phone number.

mobile_phonestring

Mobile phone number.

fax_phonestring

Fax number.

whatsappstring

WhatsApp phone number.

phonestring

Use to search in any phone field (work, mobile, fax and WhatsApp).

createdAtGtstring date-time

Use to search for people that were created after this date.

createdAtLtstring date-time

Use to search for people that were created before this date.

updatedAtGtstring date-time

Use to search for people that were updated after this date.

updatedAtLtstring date-time

Use to search for people that were updated before this date.

withCustomFieldsboolean

Return custom fields of people. Use this param to include them in the response. Example: /people?withCustomFields=true

Response

OK

Example response

{
  "data": [
    {
      "contact": {
        "work": "(99) 9999-9999",
        "mobile": "(99) 99999-9999",
        "whatsapp": "+5511999999999"
      },
      "address": {
        "postalCode": "99999-999"
      }
    }
  ]
}