Create a User Record

post/public/v1/user-records

Accepts documents as temporary upload ids, in the same form as the Upload a Document to a User endpoint.

post/public/v1/user-records

curl --request POST \
  --url 'https://api.app.astalty.com.au/public/v1/user-records' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "user": {
    "id": "string"
  },
  "user_record_type": {
    "id": "string"
  },
  "issue_date": "2026-07-01",
  "expiry_date": "string",
  "reference": "string",
  "documents": [
    {
      "id": "string"
    }
  ]
}'

Response

{
  "data": {
    "id": "r1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
    "name": "Working with Children Check",
    "reference": "REF-67890",
    "status": "current",
    "signature_status": "signed",
    "issue_date": "2024-01-15T00:00:00+00:00",
    "expiry_date": "2025-01-15T00:00:00+00:00",
    "created_at": "2024-01-15T10:30:00+00:00",
    "verified_at": "2024-01-16T09:00:00+00:00",
    "declined_at": "2024-01-16T09:00:00+00:00",
    "decline_reason": "The uploaded document is illegible.",
    "user": {
      "id": "u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
      "full_name": "Jane Smith"
    },
    "record_type": {
      "id": "rt1a2b3c-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
      "name": "Working with Children Check"
    },
    "verified_by": {
      "id": "u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
      "full_name": "Jane Smith"
    },
    "declined_by": {
      "id": "u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
      "full_name": "Jane Smith"
    }
  }
}

Authorization

Authorizationstringrequired
Bearer authentication header of the form Bearer <token>, where <token> is your API key. See How to set up an API key.

Body

application/json

userobjectrequired
▶Show 1 child attributesHide child attributes
- idstringrequired
user_record_typeobjectrequired
▶Show 1 child attributesHide child attributes
- idstringrequired
issue_datestring<date>required
expiry_datestring
referencestring | nullmax length 255
documentsobject[] | nullmin items 1max items 20
▶Show 1 child attributesHide child attributes
- idstringrequired

Response

200application/json

UserRecordResource

dataobjectrequired
▶Show 15 child attributesHide child attributes
- idstringrequired
  Example:r1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
- namestring | nullrequired
  Example:Working with Children Check
- referencestring | nullrequired
  Example:REF-67890
- statusenum<string>required
  Available options:archivedawaiting-verificationcurrentdeclinedexpiredmissing
- signature_statusenum<string>required
  Available options:awaiting_signaturesnot_requirednot_sentsigned
- issue_datestring | nullrequired
  Example:2024-01-15T00:00:00+00:00
- expiry_datestring | nullrequired
  Example:2025-01-15T00:00:00+00:00
- created_atstringrequired
  Example:2024-01-15T10:30:00+00:00
- verified_atstring | nullrequired
  Example:2024-01-16T09:00:00+00:00
- declined_atstring | nullrequired
  Example:2024-01-16T09:00:00+00:00
- decline_reasonstring | nullrequired
  Example:The uploaded document is illegible.
- userobjectrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
  full_namestringrequired
  Example:Jane Smith
- record_typeobjectrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:rt1a2b3c-d4e5-6f7a-8b9c-0d1e2f3a4b5c
  namestringrequired
  Example:Working with Children Check
- verified_byobject | nullrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
  full_namestringrequired
  Example:Jane Smith
- declined_byobject | nullrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
  full_namestringrequired
  Example:Jane Smith

Errors

401Unauthenticated
403Authorization error
422Validation error