---
title: "List persons"
method: GET
path: "/apps/{appId}/persons"
tags: ["Persons"]
---

# List persons

`GET /apps/{appId}/persons`

Get all persons

## Path parameters

- `appId` integer, required

## Query parameters

- `limit` integer
- `search` string
- `filters` object[]
  - `name` string
  - `value` string
  - `comparator` '=' | '<' | '>' | '<=' | '>=' | '!=' | 'LIKE' | 'IN' | 'REGEX' | 'NOT LIKE' | 'NOT <=>' | '<=>'
- `order` object[]
  - `name` string — Column name
  - `direction` 'asc' | 'desc' | 'closest'
  - `value` integer — Value for closest amount

## Response `200`

Success

- ContactPerson[]
  - `id` integer
  - `civility` string, nullable — Civility is the lastname prefix
  - `lastname` string
  - `firstname` string
  - `establishments` EstablishmentIdentity[]
    - `id` integer, nullable — The identifier of the establishment can be absent if the data comes from the INSEE database. In this case, it is not editable
    - `name` string — Establishment name
    - `nic` string, nullable — Establishment number (french NIC)
    - `place` object
      - `id` integer
      - `latitude` integer
      - `longitude` integer
      - `street_number` string
      - `route` string
      - `route2` string
      - `locality` string
      - `sublocality` string
      - `administrative_area_level3` string
      - `administrative_area_level2` string
      - `administrative_area_level1` string
      - `country` string
      - `countryiso2` string
      - `postal_code` string
      - `formatted_address` string — When obtaining data, the formatted address is automatically composed from the other properties of the object. When updating data, the formatted address can be used to automatically hydrate the other properties from Google Maps
    - `emails` string[]
    - `phones` string[]
  - `image` string, uri
  - `metadata` unknown[], nullable
    - unknown

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.net/sinao/apis/sinao-api.md) · [All operations](https://skmtc.net/sinao/apis/sinao-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinao/sinao-api/versions/436b47b78bf4/schema)