---
title: "One audience: what it is, the tags it stamps, grades and pay."
method: GET
path: "/v1/interest-audiences/{slug}"
tags: ["audiences"]
---

# One audience: what it is, the tags it stamps, grades and pay.

`GET /v1/interest-audiences/{slug}`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/interest-audiences/{slug}`
- Auth: none required

## Path parameters

- `slug` string, required

## Response `200`

OK

- AudiencesGetResponse
  - `audience` object, required
    - `slug` string, required
    - `name` string, required
    - `summary` string, required
    - `overview` string[], required
    - `whoFor` string, required
    - `imageUrl` string, nullable, required
    - `status` 'draft' | 'recruiting' | 'live' | 'closed', required
    - `geoAllow` string[], required
    - `languages` string[], required
    - `tags` object[], required
      - `id` string, required
      - `label` string, required
    - `grades` object[], required
      - `grade` union, required
        - 1
        - 2
        - 3
      - `name` string, required
      - `pricePence` integer, required
      - `headPayPence` integer, required
      - `how` 'quiz' | 'work_email_domain' | 'org_code' | 'review', required
    - `poolBand` 'under_50' | '50_200' | '200_500' | '500_plus', required
    - `country` string, nullable, required
    - `geoOk` boolean, required
    - `quiz` object, required
      - `items` integer, required
      - `passMark` integer, required
      - `timeLimitS` integer, required
    - `trustedDomains` string[], required

## Other responses

- `404`: No such question, endpoint or delivery on this account.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)