DevelopersYour tokens
Reference

People & things

Who and what the documents are about: people, pets, vehicles, homes, accounts, policies, companies. Renamed, combined and answered here as on the page.

GETEveryone and everything/people-and-thingsGETOne person or thing/people-and-things/{entity}PATCHCorrect a person or thing/people-and-things/{entity}
#

Everyone and everything

GETapi.thawed.app/v1/people-and-things
Scope: read · every token has it

By kind, each with how much paper it is on and the one status Home shows. VINs, plates and the like are details that come back only with the identifiers scope.

Query
kindstringquery
personpetvehiclepropertyorganizationaccountpolicyitem
include_gonebooleanquery
Include what was sold, ended or said to be not yours.
Responses
200
The list.
401
No token, a token that has ended, or one issued for the other door. WWW-Authenticate names the resource metadata document.
Problem
422
A field was wrong. errors names each one.
Problem
200 answer
people_and_thingsarray of any
totalinteger
urlstring
Request
curl "https://api.thawed.app/v1/people-and-things" \
  -H "Authorization: Bearer $THAW_TOKEN"
Response 200
{
  "people_and_things": [
    {
      "id": "019958a0-3e60-7f5c-9d41-5b2e4c80af33",
      "name": "Marisol Alvarez",
      "kind": "person",
      "kind_label": "Person",
      "subtitle": "Due 1 October · $129.50",
      "also_known_as": [
        "string"
      ],
      "details": {},
      "gone": "2025-06-30",
      "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11",
      "documents": 412,
      "status": {
        "text": "When does the electric bill come due?",
        "when": "2026-09-12",
        "more": 3
      }
    }
  ],
  "total": 412,
  "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
}
#

One person or thing

GETapi.thawed.app/v1/people-and-things/{entity}
Scope: read · every token has it

The current facts about it, its documents, what is due and what is missing.

Path
entitystring (uuid)pathrequired
A person or thing's id.
Responses
200
The person or thing in full.
401
No token, a token that has ended, or one issued for the other door. WWW-Authenticate names the resource metadata document.
Problem
404
Nothing of that id in this family or business.
Problem
200 answer
person_or_thingPersonOrThing
statusStatus
The one line Home shows for a person or thing.
factsarray of Fact
identifiers_shownboolean
documentsarray of DocumentRow
up_nextarray of UpNext
missingarray of object
Request
curl "https://api.thawed.app/v1/people-and-things/019958a0-3e60-7f5c-9d41-5b2e4c80af33" \
  -H "Authorization: Bearer $THAW_TOKEN"
Response 200
{
  "person_or_thing": {
    "id": "019958a0-3e60-7f5c-9d41-5b2e4c80af33",
    "name": "Marisol Alvarez",
    "kind": "person",
    "kind_label": "Person",
    "subtitle": "Due 1 October · $129.50",
    "also_known_as": [
      "string"
    ],
    "details": {},
    "gone": "2025-06-30",
    "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
  },
  "status": {
    "text": "When does the electric bill come due?",
    "when": "2026-09-12",
    "more": 3
  },
  "facts": [
    {
      "id": "019958a0-4f71-706d-8e52-6c3f5d91b044",
      "key": "staging/019958a0-2d5f…/scan.pdf",
      "label": "Amount due",
      "role": "money",
      "value": "$129.50",
      "number": 129.5,
      "date": "2026-09-12",
      "currency": "USD",
      "page": 1,
      "corrected_by_hand": false
    }
  ],
  "identifiers_shown": false,
  "documents": [
    {
      "id": "019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11",
      "title": "Bluebonnet Electric bill September 2026",
      "type": "utilities/electric-bill",
      "category": "home",
      "date": "2026-09-12",
      "period": {
        "from": "marisol@example.com",
        "to": "billing@bluebonnet.example"
      },
      "status": "filed",
      "needs_look": false,
      "read": "full",
      "superseded": false,
      "duplicate": false,
      "people_and_things": [
        {
          "id": "019958a0-3e60-7f5c-9d41-5b2e4c80af33",
          "title": "Bluebonnet Electric bill September 2026",
          "name": "Marisol Alvarez",
          "kind": "document",
          "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11",
          "role": "subject"
        }
      ],
      "arrived": "2026-09-12",
      "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
    }
  ],
  "up_next": [
    {
      "id": "019958a0-2d5f-7e4b-8c30-4a1d3b7f9e22",
      "kind": "document",
      "kind_label": "Person",
      "title": "Bluebonnet Electric bill September 2026",
      "due": "2026-10-01",
      "status": "filed",
      "snoozed_until": "2026-10-01",
      "amount": 129.5,
      "currency": "USD",
      "if_missed": "A late fee of $10 and a possible disconnection notice.",
      "what_to_do": {
        "summary": "The September bill: $129.50, due 1 October, paid by autopay.",
        "steps": [
          "string"
        ],
        "phone": "+1 512 555 0142",
        "links": [
          "string"
        ],
        "prepared": "2026"
      },
      "document": {
        "id": "019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11",
        "title": "Bluebonnet Electric bill September 2026",
        "name": "scan.pdf",
        "kind": "document",
        "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
      },
      "person_or_thing": {
        "id": "019958a0-3e60-7f5c-9d41-5b2e4c80af33",
        "title": "Bluebonnet Electric bill September 2026",
        "name": "Marisol Alvarez",
        "kind": "person",
        "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
      },
      "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
    }
  ],
  "missing": [
    {}
  ]
}
#

Correct a person or thing

PATCHapi.thawed.app/v1/people-and-things/{entity}
Scope: write · change things, on a paid planTakes Idempotency-Key

The name, the kind, what is known about it (attributes, merged; a null value removes one), when it was sold or ended (disposed_at), whether it is pinned, and whether it is part of the household (household, which is what the setup cards ask). At least one field. Something disposed of has its open items closed.

Path
entitystring (uuid)pathrequired
A person or thing's id.
Headers
Idempotency-Keystringheader
Any string of the caller's choosing. The same key with the same body within a day replays the first answer, marked Idempotent-Replayed: true; with a different body it is 422; while the first call is still running it is 409.
BodyJSON
namestring
kindstring
personpetorganizationpropertyvehiclefinancial_accountpolicyasset
attributesobject
disposed_atstring (date) or null
pinnedboolean
householdboolean or null
Responses
200
As it stands now.
401
No token, a token that has ended, or one issued for the other door. WWW-Authenticate names the resource metadata document.
Problem
403
The token, the role or the plan does not allow it. A missing scope is named in scope and in the WWW-Authenticate header as insufficient_scope; a plan that does not come with it says which one does.
Problem
404
Nothing of that id in this family or business.
Problem
422
A field was wrong. errors names each one.
Problem
200 answer
person_or_thingPersonOrThing
Request
curl -X PATCH "https://api.thawed.app/v1/people-and-things/019958a0-3e60-7f5c-9d41-5b2e4c80af33" \
  -H "Authorization: Bearer $THAW_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"Marisol Alvarez","kind":"person","attributes":{"key":null},"disposed_at":"2025-06-30","pinned":false,"household":true}'
Body
{
  "name": "Marisol Alvarez",
  "kind": "person",
  "attributes": {
    "key": null
  },
  "disposed_at": "2025-06-30",
  "pinned": false,
  "household": true
}
Response 200
{
  "person_or_thing": {
    "id": "019958a0-3e60-7f5c-9d41-5b2e4c80af33",
    "name": "Marisol Alvarez",
    "kind": "person",
    "kind_label": "Person",
    "subtitle": "Due 1 October · $129.50",
    "also_known_as": [
      "string"
    ],
    "details": {},
    "gone": "2025-06-30",
    "url": "https://go.thawed.app/documents/019958a0-1c4e-7d3a-9b2f-3f0c2a6e8d11"
  }
}