Correct working contact fields on a basic submission

POST /v1/supplier-submissions/{submission_id}/contact-corrections

Correct working contact fields on a basic submission

cURL

curl --request POST \
  --url https://sandbox-api.terabusinessfinance.com/v1/supplier-submissions/{submission_id}/contact-corrections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "operation_idempotency_key": "<string>",
  "expected_revision": 4503599627370495
}
'

200

accepted_basic_after_correction

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

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

Body

application/json

operation_idempotency_key · string · required

Required string length: 8 - 128

expected_revision · integer · required

Required range: 0 <= x <= 9007199254740991

first_name · string

Required string length: 1 - 100

last_name · string

Required string length: 1 - 100

telephone · string

Required string length: 1 - 20

email · string

Required string length: 1 - 320

preferred_contact_method · enum<string>

Available options: email, phone, either

Response

200

application/json

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