Counterparties

Retrieve counterparty

Changed on

Retrieves a counterparty owned by the merchant.

get/v1/counterparties/{id}

Request

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

Path parameters

idstring uuid required

Unique identifier of the counterparty.

Response

The counterparty resource

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

  • f7ded6c181abRevision changes
    • info

      endpoint added

  • e0010b51834aRevision changes
    • info

      added to the response property anyOf list for the response status

    • info

      added the required property to the response with the status