---
title: "GET /organizations/{organization_id}/people"
method: GET
path: "/organizations/{organization_id}/people"
tags: ["people"]
---

# GET /organizations/{organization_id}/people

`GET /organizations/{organization_id}/people`

## Request

- Base URL: `https://api.agendor.com.br/v3`
- URL: `https://api.agendor.com.br/v3/organizations/{organization_id}/people`
- Auth: API key in header `Authorization`

List all people of an organization.

## Path parameters

- `organization_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

OK

- object
  - `data` PersonEntity[]
    - `id` integer: Person ID.
    - `accountId` integer: Account ID.
    - `name` string: Person's name.
    - `email` string: Contact email.
    - `organization` object: Related organization info.
      - `id` string: Organization ID.
      - `name` string: Display name (Nome fantasia).
      - `email` string: Contact email.
    - `cpf` string: Document number (CPF).
    - `role` string: Person's role in organization.
    - `ranking` 0 | 1 | 2 | 3 | 4 | 5: Numeric ranking.
    - `description` string: Person description.
    - `birthday` string: Person's birthdate.
    - `avatar` string, url: Avatar image URL.
    - `createdAt` unknown
    - `updatedAt` unknown
    - `products` ProductEntity[]: Associated products.
      - `id` integer: Product ID.
      - `name` string: Product name.
      - `code` string: Product code.
      - `categoryId` integer: Product category id.
      - `price` number, double: Product price.
      - `unit` string: Product unit.
      - `active` boolean: Product active.
      - `imageUrl` string: Product image URL.
      - `imageThumbUrl` string: Product image thumbnail URL.
      - `createdAt` unknown
      - `customFields` unknown
      - `description` string: Product description (HTML).
    - `contact` object: Contact information.
      - `email` string, email: Email address.
      - `work` string: Formatted work phone number.
      - `mobile` string: Formatted mobile phone number.
      - `fax` string: Formatted fax number.
      - `ramal` string: Phone line branch number.
      - `radio` string: Radio phone number.
      - `whatsapp` string: WhatsApp phone number.
      - `facebook` string, url: Facebook profile URL.
      - `twitter` string, url: Twitter profile URL.
      - `linkedIn` string, url: LinkedIn profile URL.
      - `skype` string: Skype username.
      - `instagram` string, url: Instagram profile URL.
    - `address` object: Address information.
      - `country` string: Country name.
      - `district` string: District (city subdivision) name.
      - `streetName` string: Street name.
      - `streetNumber` integer: Building number.
      - `additionalInfo` string: Additional address info.
      - `postalCode` string: Postal code (CEP).
      - `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': State abbreviation.
      - `city` string: City name.
    - `category` object: Associated category.
      - `id` integer: Category ID.
      - `name` string: Category name.
    - `leadOrigin` object: Associated lead origin.
      - `id` integer: Lead origin ID.
      - `name` string: Lead origin name.
    - `author` object: User that created this organization.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `ownerUser` object: User that currently owns this organization.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `allowedUsers` LeanUserEntity[]: Users allowed to view this organization.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `customFields` object: Custom fields.
    - `_webUrl` string, url: Web platform URL.

---

[API](https://skmtc.dev/agendor/apis/agendor-api.md) - [All operations](https://skmtc.dev/agendor/apis/agendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agendor/apis/agendor-api/revisions/86c250dbf468?raw)