---
title: "Create async targeting job"
method: POST
path: "/v1/data/targeting/meta/jobs"
tags: ["Targeting"]
---

# Create async targeting job

`POST /v1/data/targeting/meta/jobs`

## Request

- Base URL: `https://api.mapulus.com`
- URL: `https://api.mapulus.com/v1/data/targeting/meta/jobs`
- Auth: HTTP bearer

Create an async targeting job (explicit async path).

Always creates a background job regardless of boundary size.
If the result is already cached, returns 200 with the completed result.

## Query parameters

- `boundary_id` string, required: Comma-separated boundary IDs to target (e.g. 'sa2:117011325,lga:17200'). Max 20.
- `radius_unit` 'kilometer' | 'mile': Unit for output radius values.
- `mode` 'circles' | 'postal': Targeting mode: 'circles' (default) or 'postal' (ZIP/postcode inclusion + exclusion circles).

## Response `202`

Job created for background processing.

- ResponseEnvelopeTargetingJobCreated
  - `data` TargetingJobCreated, required: Response when an async targeting job is created.
    - `job_id` string, required: UUID of the created job.
    - `status` string, required: Job status (queued, processing, completed, failed).
    - `poll_url` string, required: URL to poll for job status.
    - `created_at` string, date-time, required: When the job was created.
  - `meta` ResponseMeta: Response metadata.
    - `request_id` string, nullable
    - `pagination` PaginationMeta: Pagination metadata for list responses.
      - `total` integer, required: Total number of matching records.
      - `limit` integer, required: Maximum records returned per page.
      - `offset` integer, required: Number of records skipped.
      - `has_more` boolean, required: Whether more records exist beyond this page.
    - `demographics` DemographicsMeta: Demographics-specific metadata returned with census data endpoints.
      - `topics_included` string[], required: Topics included in the response.
      - `topics_available` string[]: Additional topics available but not requested.
    - `sources` object, nullable

## Other responses

- `422`: Validation Error

---

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