Get a Supplier Submission by Tera id

curl --request GET \
  --url https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "environment": "sandbox",
  "submission_id": "11111111-1111-4111-8111-111111111111",
  "external_reference": "northbridge-enq-1001",
  "level": "basic",
  "status": "accepted",
  "received_at": "2026-08-29T09:00:00.000Z",
  "decided_at": "2026-08-29T09:12:00.000Z",
  "application_reference": null,
  "application_created_at": null,
  "billing": {
    "billing_status": "not_billable",
    "billable_at": null,
    "billing_model": "accepted_submission",
    "not_billable_reason": "sandbox"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication failed"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Credential is not authorised for this operation"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Submission not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after the Retry-After header."
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "Operation could not be completed"
  }
}

GET

supplier-submissions

{submission_id}

Get a Supplier Submission by Tera id

curl --request GET \
  --url https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "environment": "sandbox",
  "submission_id": "11111111-1111-4111-8111-111111111111",
  "external_reference": "northbridge-enq-1001",
  "level": "basic",
  "status": "accepted",
  "received_at": "2026-08-29T09:00:00.000Z",
  "decided_at": "2026-08-29T09:12:00.000Z",
  "application_reference": null,
  "application_created_at": null,
  "billing": {
    "billing_status": "not_billable",
    "billable_at": null,
    "billing_model": "accepted_submission",
    "not_billable_reason": "sandbox"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication failed"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Credential is not authorised for this operation"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Submission not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after the Retry-After header."
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "Operation could not be completed"
  }
}

Authorizations

Authorization

string

header

required

Canonical form uses underscore only: tcs_test_<public_id> or tcs_live<public_id>_. Scopes: supplier_submissions:create:basic, supplier_submissions:create:application, supplier_submissions:read, supplier_submissions:correct, supplier_submissions:promote. Effective permission is account ∩ credential ∩ environment. HMAC pepper is SUPPLIER_API_KEY_PEPPER.

Headers

X-Request-Id

string

Optional caller correlation id. Tera always returns X-Request-Id; that header is the only correlation identifier.

Required string length: 1 - 128

Path Parameters

submission_id

string<uuid>

required

Response

Current supplier-visible object. Used for identical create replay and GET.

environment

enum<string>

required

Available options:

sandbox,

production

submission_id

string<uuid>

required

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

external_reference

string

required

Required string length: 1 - 128

level

enum<string>

required

Available options:

basic,

application

status

enum<string>

required

Available options:

received,

accepted,

duplicate_not_accepted,

rejected

received_at

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

decided_at

string<date-time> | null

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

application_reference

string | null

required

application_created_at

string<date-time> | null

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

billing

object

required

Show child attributes

Submissions

Corrections

Promotion

Get a Supplier Submission by Tera id

Authorizations

Headers

Path Parameters

Response