Skip to main content
GET
Get a registration by ID
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

GET /work/registrations/ Description: Fetches a single WorkRegistration, tenant-scoped through its linked work. Response is the bare registration object (no success/data wrapper). Authorization:
  • Required role: user or higher
Method: GET

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Response

Registration retrieved

id
string<uuid>
workId
string<uuid> | null
tenantId
integer
societyCode
string

2-3 character society code (e.g. ASCAP, BMI, PRS)

societyName
string
registrationStatus
enum<string>
default:pending
Available options:
pending,
submitted,
registered,
rejected,
conflict,
cancelled
statusDate
string<date-time>
confirmationNumber
string | null
registrationId
string | null

External/society-assigned registration identifier (distinct from the row's own id)

notes
string | null
metadata
object
queuedAt
string<date-time> | null

Set when the row is explicitly queued for PRO submission; null on creation

submittedAt
string<date-time> | null
submissionFileId
string | null
submissionFileHash
string | null
attempts
integer
default:0
lastAttemptAt
string<date-time> | null
lastErrorMessage
string | null
isDeadLettered
boolean
work
object | null

Present when eager-loaded