---
title: "Get an audience size"
method: GET
path: "/models/{modelId}/size/{jobId}"
---

# Get an audience size

`GET /models/{modelId}/size/{jobId}`

## Request

- Base URL: `https://api.hightouch.com/api/v1`
- URL: `https://api.hightouch.com/api/v1/models/{modelId}/size/{jobId}`
- Auth: HTTP bearer

Get the state of an audience size job.

## Path parameters

- `modelId` number, double, required
- `jobId` string, required

## Response `200`

Ok

- union
  - AudienceSizeJob: The status of an audience size job.
    - `jobId` string, required
    - `status` 'pending' | 'success' | 'failed' | 'cancelled', required
    - `size` number, double, nullable, required: The size of the audience. Set if `status` is "success".
    - `evaluatedAt` string, date-time, nullable, required: The timestamp when the job finished. Set if `status` is "success".
    - `error` string, nullable, required: The reason the job failed. Set if `status` is "failed".
  - ValidateErrorJSON
    - `message` 'Validation failed', required
    - `details` object, required
  - 'Internal Server Error'

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Failed
- `500`: Something went wrong

## Changes

- **2026-09-16** `8cbdd0fc09d2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hightouch/apis/hightouch-api/changes/models/:modelId/size/:jobId/get.md)

---

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