Activation

Serve kit activation page

get

Returns an HTML page for end users to activate their test kit and provide test-taker information

Query parameters

kit_idstringRequired

Supplier Kit ID from test kit packaging

Responses

200

HTML activation form

text/html

stringOptional

400

Invalid kit ID

text/html

500

Internal server error

text/html

get

/activate

HTTPcURLJavaScriptPython

GET /activate?kit_id=text HTTP/1.1
Host: vantage.tryterra.co
Accept: */*

text

Activate a test kit

post

Registers test-taker details with the supplier and updates order item status. This endpoint is called after the test-taker receives their kit and provides their information.

Body

application/json

Information provided by test-taker when activating their kit

collection_datestringOptionalExample: 2025-11-15T09:00:00Z

supplier_kit_idstringOptionalExample: KIT123456789

Responses

200

Kit activated successfully

application/json

Confirmation that kit was activated successfully

kit_idstringOptionalExample: KIT123456789

messagestringOptionalExample: Kit activated successfully

successbooleanOptionalExample: true

400

Invalid request body or kit already activated

application/json

404

Kit not found

application/json

409

Kit already activated

application/json

500

Internal server error

application/json

503

Supplier service unavailable

application/json

post

/activate/kit

HTTPcURLJavaScriptPython

POST /activate/kit HTTP/1.1
Host: vantage.tryterra.co
Content-Type: application/json
Accept: */*
Content-Length: 440

{
  "address": {
    "address_line_1": "456 Oxford Street",
    "address_line_2": "Apt 7C",
    "administrative_area": "Greater Manchester",
    "city": "Manchester",
    "country_code": "GB",
    "postal_code": "M1 5GD"
  },
  "collection_date": "2025-11-15T09:00:00Z",
  "recipient": {
    "country_code": 44,
    "date_of_birth": "1985-03-20",
    "email": "[email protected]",
    "first_name": "John",
    "gender_at_birth": "m",
    "last_name": "Smith",
    "phone_number": 447700900456
  },
  "supplier_kit_id": "KIT123456789"
}

{
  "kit_id": "KIT123456789",
  "message": "Kit activated successfully",
  "success": true
}