---
title: "Enrich up to 10 contacts and add them to a list (spends credits)"
method: POST
path: "/prospecting/acquire"
tags: ["Prospecting"]
---

# Enrich up to 10 contacts and add them to a list (spends credits)

`POST /prospecting/acquire`

## Request

- Base URL: `https://mcp.senders.ai/api/v1`
- URL: `https://mcp.senders.ai/api/v1/prospecting/acquire`
- Auth: HTTP bearer

Scope: prospecting:run. As enrich, plus everyone found with an email is added to list_id.

## Headers

- `Idempotency-Key` string, required

## Request body

- AcquireBody
  - `contact_ids` string[], required
  - `max_spend_credits` integer, required: Hard limit for this request. Must not exceed what is left of the API spend cap today.
  - `list_id` integer, required: One of your people lists

## Response `200`

OK

- SuppressionsResult
  - `data` object
    - `added` integer
    - `already_suppressed` integer
    - `invalid` string[]
    - `not_processed` string[]: Not reached within the time budget; send again

## Other responses

- `400`: bad_request, idempotency_key_required or max_spend_required
- `401`: Missing, wrong or revoked token
- `402`: spend_cap_reached or estimate_exceeds_max_spend: refused before anything was charged
- `403`: Missing write permission, inactive account, or feature not enabled
- `404`: No such list on this account
- `409`: busy, conflict, idempotency_in_progress (retry) or a final conflict such as campaign_closed
- `413`: Body over 1 MB
- `415`: Body not JSON
- `422`: Idempotency-Key reused for a different request
- `429`: Rate or daily limit
- `503`: Writes paused because rate limiting is unavailable; retry after Retry-After

---

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