API reference

Retrieve a confirmation

Returns one confirmation with its full timeline of events.

GET/v1/confirmations/{id}

Fetch the latest state of a confirmation by its id: the status, the outcome, every step and the full event history, including call transcripts.

curl https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658 \
  -H "Authorization: Bearer $ANYONEIN_KEY"

const res = await fetch(
  'https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658',
  { headers: { Authorization: `Bearer ${process.env.ANYONEIN_KEY}` } },
);
const { confirmation } = await res.json();

res = requests.get(
    "https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658",
    headers={"Authorization": f"Bearer {os.environ['ANYONEIN_KEY']}"},
    timeout=15,
)
confirmation = res.json()["confirmation"]

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

Response200 OK

{
  "confirmation": {
    "id": "cf_7d2a9c41e0b3f658",
    "externalId": "HF-100482",
    "status": "rescheduled",
    "outcome": {
      "intent": "pick_option",
      "summary": "Moved to Thursday 15 October, 8am–12pm.",
      "signerName": null,
      "preferred": null,
      "newSlot": { "date": "2026-10-15", "window": { "from": "08:00", "to": "12:00" } },
      "channel": "call",
      "at": "2026-10-12T10:01:37.215Z"
    },
    "order": {
      "ref": "HF-100482",
      "type": "delivery",
      "date": "2026-10-15",
      "window": { "from": "08:00", "to": "12:00" },
      "previous": { "date": "2026-10-13", "window": { "from": "08:00", "to": "12:00" } }
    },
    "events": [
      { "id": "ev_8c21f04b9e", "kind": "out", "channel": "call", "text": "Hello, this is the automated delivery assistant for Harlow & Finch, calling about your delivery. Am I speaking with Priya?" },
      { "id": "ev_1d9a6e3c70", "kind": "in", "channel": "call", "text": "Yes, speaking." },
      { "id": "ev_5b0e72a8f1", "kind": "out", "channel": "call", "text": "Thanks Priya. Your sofa is due on Tuesday the thirteenth, between 8am and 12pm. Will someone be in to sign for it?" },
      { "id": "ev_c4f3e19d02", "kind": "in", "channel": "call", "text": "Tuesday's no good, any chance of Thursday?" },
      { "id": "ev_7a2b8d6e45", "kind": "out", "channel": "call", "text": "I can do Thursday the fifteenth, between 8am and 12pm. Shall I book that?" },
      { "id": "ev_e09c1b7f38", "kind": "in", "channel": "call", "text": "Perfect, yes." },
      { "id": "ev_2f6d4a0c9b", "kind": "outcome", "channel": "call", "intent": "pick_option", "tone": "good", "text": "Moved to Thursday 15 October, 8am–12pm." }
    ]
  }
}

Path parameters

idstringrequired: The confirmation's id, such as cf_7d2a9c41e0b3f658.

Returns

200 OK with { "confirmation": … }: the full confirmation object, including events. The sample on the right is abridged to the fields that changed after a call in which the customer moved to another slot.

An id that doesn't exist, or isn't in the right format, returns 404 with "error": "No confirmation with that id.".

When to poll

You don't need to: the webhook tells you when there's an outcome. Retrieve is for showing the live timeline to your team, for checking the state after a missed webhook, and for pulling the transcript into your customer-service tool.

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

#Path parameters

#Returns

#When to poll

Path parameters

Returns

When to poll