Skip to content
BC Government LogoAddress Change

Get an address-change draft

GET
/api/v1/address-change/drafts/{requestId}
curl --request GET \
  --url https://address-change-test.apps.gold.devops.gov.bc.ca/api/v1/address-change/drafts/7c825573-3df5-4e63-b376-ef7a4057369d \
  --header 'Authorization: Bearer <token>'

Returns a draft address-change request owned by the authenticated resident. Drafts owned by other residents are reported as not found.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
requestId
required
string format: uuid

Example 

7c825573-3df5-4e63-b376-ef7a4057369d

Identifier of the address-change request, as returned on creation.

Responses

Section titled “Responses”

200

Section titled “200”

The request completed successfully.

Media typeapplication/json
object
requestId
required
string format: uuid
idempotencyKey
required
string
status
required
string
Allowed values: DRAFT
draft
required
object
step
required
integer
<= 10
values
required
object
key
additional properties
any

Example 

{
  "requestId": "7c825573-3df5-4e63-b376-ef7a4057369d",
  "idempotencyKey": "draft-7f3a",
  "status": "DRAFT",
  "draft": {
    "step": 2,
    "values": {
      "firstName": "Alex"
    }
  }
}

400

Section titled “400”

The request is malformed or fails validation. The body is an RFC 9457 problem details object; errors lists the invalid fields without echoing their values.

Media typeapplication/json
object
type
required
string
title
required
string
status
required
integer
detail
required
string
errors
required
Array<object>
>= 1 items
object
type
required
string
code
required
string
message
required
string
location
required
string
Allowed values: body query header path cookie

Example 

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request body",
  "errors": [
    {
      "type": "validation",
      "code": "invalid_string",
      "message": "Invalid value at /person/dateOfBirth",
      "location": "body"
    }
  ]
}

401

Section titled “401”

A valid bearer access token is required.

Media typeapplication/json
object
statusCode
required
number
message
required
string
error
required
string

Example 

{
  "statusCode": 401,
  "message": "A bearer access token is required",
  "error": "Unauthorized"
}

403

Section titled “403”

The access token does not include the required scope.

Media typeapplication/json
object
statusCode
required
number
message
required
string
error
required
string

Example 

{
  "statusCode": 403,
  "message": "Missing address-change submission permission",
  "error": "Forbidden"
}

404

Section titled “404”

The requested resource was not found for this resident.

Media typeapplication/json
object
statusCode
required
number
message
required
string
error
required
string

Example 

{
  "statusCode": 404,
  "message": "Draft not found",
  "error": "Not Found"
}

503

Section titled “503”

The service or a downstream partner is temporarily unavailable.

Media typeapplication/json
object
statusCode
required
number
message
required
string
error
required
string

Example 

{
  "statusCode": 503,
  "message": "Request could not be saved",
  "error": "Service Unavailable"
}