Counterparties

Activate counterparty

Changed on

Activates a pending counterparty owned by the merchant. A fiat counterparty becomes active immediately; a crypto counterparty starts verification and stays pending until it concludes.

post/v1/counterparties/{id}/activate

Request

  • Base URL
    https://api.augustus.com
  • URL
    https://api.augustus.com/v1/counterparties/{id}/activate
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Unique identifier of the counterparty.

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Response

The counterparty

status'pending' | 'active' | 'rejected' required

Counterparty lifecycle status. Blocking is separate.

idstring uuid required

Unique identifier of the counterparty.

type'counterparty' required

Resource type discriminator.

namestring nullable required

Name of the counterparty, or null if not recorded.

entity_type'business' | 'individual' | 'non_profit' | 'sole_proprietor' required

Classification of the counterparty.

date_of_birthstring date nullable required

Date of birth in YYYY-MM-DD format, or null if not recorded.

phonestring nullable required

Phone number of the counterparty, or null if not recorded.

emailstring nullable required

Email address of the counterparty, or null if not recorded.

legal_idstring nullable required

National tax or identity number of the counterparty, or null if not recorded.

is_self_ownedboolean required

Whether the counterparty is self-owned. false if the counterparty is not owned by you, true if it is.

blockedboolean required

Whether payments to or from this counterparty are currently blocked.

metadataobject required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

Example response

{
  "status": "active",
  "name": "Acme Sandbox Ltd.",
  "entity_type": "business",
  "physical_address": {
    "line_1": "548 Market St",
    "line_2": "Apartment 4B",
    "city": "San Francisco",
    "postal_code": "94103",
    "state": "CA",
    "country_code": "DE"
  },
  "financial_address": {
    "type": "aba",
    "routing_number": "110000000",
    "account_number": "000123456789",
    "account_holder_name": "Acme Sandbox Ltd.",
    "account_type": "checking"
  },
  "date_of_birth": "1990-01-15",
  "phone": "+55 11 91234 5678",
  "email": "finance@example.com",
  "legal_id": "12.345.678/0001-95",
  "metadata": {
    "invoice_id": "INV-2026-0042"
  }
}

Changes