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"
}'

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",
    "user": {
      "id": "u1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b",
      "full_name": "Jane Smith"
    },
    "record_type": {
      "id": "rt1a2b3c-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
      "name": "Working with Children Check"
    }
  }
}

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

Response

200application/json

UserRecordResource

dataobjectrequired
▶Show 10 child attributesHide child attributes
- idstringrequired
  Example:r1a2b3c4-d5e6-47f8-9a0b-1c2d3e4f5a6b
- namestring | nullrequired
  Example:Working with Children Check
- referencestring | nullrequired
  Example:REF-67890
- statusstringrequired
  Example:current
- signature_statusstringrequired
  Example:signed
- 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
- 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

Errors

401Unauthenticated
403Authorization error
422Validation error

Command Palette

Authorization

Body

Response

Errors