---
title: "List person audience memberships"
method: GET
path: "/v5/persons/{person_id}/memberships"
tags: ["Persons"]
---

# List person audience memberships

`GET /v5/persons/{person_id}/memberships`

## Request

- Base URL: `https://api.extole.io`
- URL: `https://api.extole.io/v5/persons/{person_id}/memberships`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `access_token`
  - API key in cookie `extole_token`
- TypeScript: <https://skmtc.dev/extole/apis/integration-api-server-to-extole/docs/v5/persons/:person_id/memberships/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns audience memberships for the specified person, sorted by created date in descending order. Each membership indicates which audiences the person currently belongs to.

## Path parameters

- `person_id` string, required

## Query parameters

- `audience_ids` string[]
- `audience_names` string[]
- `offset` integer
- `limit` integer

## Response `200`

Successful response

- PersonMembershipResponse[]
  - `audience_id` string, required: Extole-assigned unique identifier for the audience.
  - `audience_name` string, required: Human-readable name of the audience.
  - `created_date` string, required: [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds.
  - `updated_date` string, required: [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `415`: Unsupported Media Type
- `429`: Too Many Requests

---

[API](https://skmtc.dev/extole/apis/integration-api-server-to-extole.md) - [All operations](https://skmtc.dev/extole/apis/integration-api-server-to-extole/llms.txt) - [OpenAPI document](https://skmtc.dev/extole/apis/integration-api-server-to-extole/revisions/c16e62e66755?raw)