API reference

List confirmations

Returns your most recent confirmations, newest first, without their event timelines.

GET/v1/confirmations

Lists confirmations in order of creation, newest first. Each one is the full confirmation object except events, which is left out to keep the list light. Retrieve a single confirmation to get its timeline.

curl "https://api.anyonein.co.uk/v1/confirmations?limit=20" \
  -H "Authorization: Bearer $ANYONEIN_KEY"

const res = await fetch('https://api.anyonein.co.uk/v1/confirmations?limit=20', {
  headers: { Authorization: `Bearer ${process.env.ANYONEIN_KEY}` },
});
const { confirmations } = await res.json();
const needsAPerson = confirmations.filter((c) => c.status === 'action_needed');

res = requests.get(
    "https://api.anyonein.co.uk/v1/confirmations",
    params={"limit": 20},
    headers={"Authorization": f"Bearer {os.environ['ANYONEIN_KEY']}"},
    timeout=15,
)
needs_a_person = [c for c in res.json()["confirmations"] if c["status"] == "action_needed"]

<?php
$ch = curl_init('https://api.anyonein.co.uk/v1/confirmations?limit=20');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ANYONEIN_KEY')],
]);
$list = json_decode(curl_exec($ch), true)['confirmations'];

Response200 OK

{
  "confirmations": [
    {
      "id": "cf_7d2a9c41e0b3f658",
      "externalId": "HF-100482",
      "status": "confirmed",
      "outcome": { "intent": "alternate_signer", "summary": "Confirmed; partner Jo will sign.", "signerName": "Jo", "channel": "sms" },
      "order": { "ref": "HF-100482", "date": "2026-10-13", "window": { "from": "08:00", "to": "12:00" } }
    },
    {
      "id": "cf_2b8e61f0a94c7d35",
      "externalId": "HF-100477",
      "status": "action_needed",
      "outcome": { "intent": "reschedule", "summary": "Can't do Wednesday, prefers any weekday after 3pm.", "preferred": "any weekday after 3pm", "channel": "email" },
      "order": { "ref": "HF-100477", "date": "2026-10-14", "window": { "from": "12:00", "to": "18:00" } }
    }
  ]
}

Query parameters

limitintegeroptional: How many to return. Default 50, maximum 200.

Returns

200 OK with { "confirmations": [ … ] }. An empty account returns an empty array. The sample is abridged to a few fields per confirmation.

Roadmap

Cursor pagination and filters (by status, externalId and date) are on the roadmap. Today the list returns the most recent confirmations up to limit, so filter on your side, and rely on webhooks rather than paging through history.

A pre-dispatch check

A common use: the afternoon before dispatch, list recent confirmations and pick out anything that's action_needed or unreachable for the team to call. Anything still scheduled or in_progress for tomorrow is worth a look too.

Base URL https://api.anyonein.co.uk/v1 is a placeholder until the production domain is confirmed. Found a mistake? Tell us.

#Query parameters

#Returns

#A pre-dispatch check

Query parameters

Returns

A pre-dispatch check