> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustus.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat the published Augustus OpenAPI specification (https://api.augustus.com/openapi/2026-05-01.json) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers.
> Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate surface covering the Pay by Bank products — Instant Bank Transfer (Open Banking) checkout and refunds, and Manual Bank Transfer (MBT); use it when one of those products is required.
> Cite or link the relevant docs.augustus.com page when answering integration questions.
> Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation.
> Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key.
> The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions.

# Activate counterparty

> 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.



## OpenAPI

````yaml https://api.augustus.com/openapi/2026-05-01.json post /v1/counterparties/{id}/activate
openapi: 3.1.0
info:
  title: Augustus Banking API
  description: Augustus Banking API
  version: 0.1.0
  contact:
    name: Augustus
    url: https://docs.augustus.com
    email: developer@augustus.com
servers:
  - url: https://api.augustus.com
    description: Production
  - url: https://api.sandbox.augustus.com
    description: Sandbox
security:
  - BearerAuth: []
tags: []
paths:
  /v1/counterparties/{id}/activate:
    post:
      tags:
        - Counterparties
      summary: Activate counterparty
      description: >-
        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.
      operationId: CounterpartiesController_activate
      parameters:
        - name: id
          required: true
          in: path
          description: Unique identifier of the counterparty.
          schema:
            type: string
            format: uuid
        - name: Idempotency-Key
          in: header
          description: >-
            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.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The counterparty
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CounterpartyResourceDto'
components:
  schemas:
    CounterpartyResourceDto:
      type: object
      properties:
        status:
          type: string
          enum:
            - pending
            - active
            - rejected
          description: Counterparty lifecycle status. Blocking is separate.
          example: active
        id:
          type: string
          format: uuid
          description: Unique identifier of the counterparty.
        type:
          type: string
          description: Resource type discriminator.
          enum:
            - counterparty
        name:
          type: string
          description: Name of the counterparty, or null if not recorded.
          example: Acme Sandbox Ltd.
          nullable: true
        entity_type:
          type: string
          enum:
            - business
            - individual
            - non_profit
            - sole_proprietor
          description: Classification of the counterparty.
          example: business
        physical_address:
          type: object
          properties:
            line_1:
              type: string
              description: Primary street address, or null if not recorded.
              example: 548 Market St
              nullable: true
            line_2:
              type: string
              description: Secondary street address, or null if not recorded.
              example: Apartment 4B
              nullable: true
            city:
              type: string
              description: City or locality.
              example: San Francisco
            postal_code:
              type: string
              description: Postal or ZIP code, or null if not recorded.
              example: '94103'
              nullable: true
            state:
              type: string
              description: State, province, or region, or null if not recorded.
              example: CA
              nullable: true
            country_code:
              $ref: '#/components/schemas/Alpha2Code'
              example: US
              description: ISO 3166-1 alpha-2 country code.
          required:
            - line_1
            - line_2
            - city
            - postal_code
            - state
            - country_code
          additionalProperties: false
          description: Physical address of the counterparty, or null if not recorded.
          nullable: true
        financial_address:
          oneOf:
            - $ref: '#/components/schemas/AbaFinancialAddress'
            - $ref: '#/components/schemas/IbanFinancialAddress'
            - $ref: '#/components/schemas/SortCodeFinancialAddress'
            - $ref: '#/components/schemas/BicFinancialAddress'
            - $ref: '#/components/schemas/CryptoWalletFinancialAddress'
          description: Financial address of the counterparty.
        date_of_birth:
          type: string
          format: date
          description: Date of birth in YYYY-MM-DD format, or null if not recorded.
          example: '1990-01-15'
          nullable: true
        phone:
          type: string
          description: Phone number of the counterparty, or null if not recorded.
          example: +55 11 91234 5678
          nullable: true
        email:
          type: string
          description: Email address of the counterparty, or null if not recorded.
          example: finance@example.com
          nullable: true
        legal_id:
          type: string
          description: >-
            National tax or identity number of the counterparty, or null if not
            recorded.
          example: 12.345.678/0001-95
          nullable: true
        is_self_owned:
          type: boolean
          description: >-
            Whether the counterparty is self-owned. `false` if the counterparty
            is not owned by you, `true` if it is.
          example: false
        blocked:
          type: boolean
          description: Whether payments to or from this counterparty are currently blocked.
          example: false
        metadata:
          type: object
          additionalProperties:
            type: string
            maxLength: 500
          description: >-
            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:
            invoice_id: INV-2026-0042
      required:
        - status
        - id
        - type
        - name
        - entity_type
        - physical_address
        - financial_address
        - date_of_birth
        - phone
        - email
        - legal_id
        - is_self_owned
        - blocked
        - metadata
      additionalProperties: false
    Alpha2Code:
      type: string
      enum:
        - AF
        - AL
        - DZ
        - AS
        - AD
        - AO
        - AI
        - AQ
        - AG
        - AR
        - AM
        - AW
        - AU
        - AT
        - AZ
        - BS
        - BH
        - BD
        - BB
        - BY
        - BE
        - BZ
        - BJ
        - BM
        - BT
        - BO
        - BA
        - BW
        - BV
        - BR
        - IO
        - BN
        - BG
        - BF
        - BI
        - KH
        - CM
        - CA
        - CV
        - KY
        - CF
        - TD
        - CL
        - CN
        - CX
        - CC
        - CO
        - KM
        - CG
        - CD
        - CK
        - CR
        - CI
        - HR
        - CU
        - CY
        - CZ
        - DK
        - DJ
        - DM
        - DO
        - EC
        - EG
        - SV
        - GQ
        - ER
        - EE
        - ET
        - FK
        - FO
        - FJ
        - FI
        - FR
        - GF
        - PF
        - TF
        - GA
        - GM
        - GE
        - DE
        - GH
        - GI
        - GR
        - GL
        - GD
        - GP
        - GU
        - GT
        - GN
        - GW
        - GY
        - HT
        - HM
        - VA
        - HN
        - HK
        - HU
        - IS
        - IN
        - ID
        - IR
        - IQ
        - IE
        - IL
        - IT
        - JM
        - JP
        - JO
        - KZ
        - KE
        - KI
        - KP
        - KR
        - KW
        - KG
        - LA
        - LV
        - LB
        - LS
        - LR
        - LY
        - LI
        - LT
        - LU
        - MO
        - MG
        - MW
        - MY
        - MV
        - ML
        - MT
        - MH
        - MQ
        - MR
        - MU
        - YT
        - MX
        - FM
        - MD
        - MC
        - MN
        - MS
        - MA
        - MZ
        - MM
        - NA
        - NR
        - NP
        - NL
        - NC
        - NZ
        - NI
        - NE
        - NG
        - NU
        - NF
        - MP
        - MK
        - 'NO'
        - OM
        - PK
        - PW
        - PS
        - PA
        - PG
        - PY
        - PE
        - PH
        - PN
        - PL
        - PT
        - PR
        - QA
        - RE
        - RO
        - RU
        - RW
        - SH
        - KN
        - LC
        - PM
        - VC
        - WS
        - SM
        - ST
        - SA
        - SN
        - SC
        - SL
        - SG
        - SK
        - SI
        - SB
        - SO
        - ZA
        - GS
        - ES
        - LK
        - SD
        - SR
        - SJ
        - SZ
        - SE
        - CH
        - SY
        - TW
        - TJ
        - TZ
        - TH
        - TL
        - TG
        - TK
        - TO
        - TT
        - TN
        - TR
        - TM
        - TC
        - TV
        - UG
        - UA
        - AE
        - GB
        - US
        - UM
        - UY
        - UZ
        - VU
        - VE
        - VN
        - VG
        - VI
        - WF
        - EH
        - YE
        - ZM
        - ZW
        - AX
        - BQ
        - CW
        - GG
        - IM
        - JE
        - ME
        - BL
        - MF
        - RS
        - SX
        - SS
        - XK
      example: DE
    AbaFinancialAddress:
      type: object
      properties:
        type:
          type: string
          description: Discriminator for ABA wire financial address.
          enum:
            - aba
        routing_number:
          type: string
          description: ABA routing number (9 digits).
        account_number:
          type: string
          description: Bank account number.
        account_holder_name:
          type: string
          description: Name of the account holder.
        account_type:
          type: string
          enum:
            - checking
            - savings
            - null
          description: >-
            Whether the account is a checking or a savings account, or null if
            not provided.
          nullable: true
      required:
        - type
        - routing_number
        - account_number
        - account_holder_name
        - account_type
      additionalProperties: false
      title: ABA
      example:
        type: aba
        routing_number: '110000000'
        account_number: '000123456789'
        account_holder_name: Acme Sandbox Ltd.
        account_type: checking
    IbanFinancialAddress:
      type: object
      properties:
        type:
          type: string
          description: Discriminator for IBAN financial address.
          enum:
            - iban
        iban:
          type: string
          description: International Bank Account Number.
        account_holder_name:
          type: string
          description: Name of the account holder.
        bic:
          type: string
          description: Bank Identifier Code, or null if not provided.
          nullable: true
        account_type:
          type: string
          enum:
            - checking
            - savings
            - null
          description: >-
            Whether the account is a checking or a savings account, or null if
            not provided.
          nullable: true
      required:
        - type
        - iban
        - account_holder_name
        - bic
        - account_type
      additionalProperties: false
      title: IBAN
      example:
        type: iban
        iban: DE89370400440532013000
        account_holder_name: Acme Sandbox Ltd.
        bic: COBADEFFXXX
        account_type: checking
    SortCodeFinancialAddress:
      type: object
      properties:
        type:
          type: string
          description: Discriminator for UK sort code financial address.
          enum:
            - sort_code
        sort_code:
          type: string
          description: UK sort code (6 digits).
        account_number:
          type: string
          description: UK account number (8 digits).
        account_holder_name:
          type: string
          description: Name of the account holder.
      required:
        - type
        - sort_code
        - account_number
        - account_holder_name
      additionalProperties: false
      title: UK Sort Code
      example:
        type: sort_code
        sort_code: '040075'
        account_number: '37778842'
        account_holder_name: Acme Sandbox Ltd.
    BicFinancialAddress:
      type: object
      properties:
        type:
          type: string
          description: Discriminator for BIC + local account financial address.
          enum:
            - bic
        bic:
          type: string
          description: ISO 9362 Bank Identifier Code (8 or 11 characters).
        account_number:
          type: string
          description: Local-format bank account number.
        account_holder_name:
          type: string
          description: Name of the account holder.
        local_bank_code:
          type: string
          description: >-
            Domestic bank or branch code where the destination country uses one
            (for example the BSB in Australia), or null.
          nullable: true
        account_type:
          type: string
          enum:
            - checking
            - savings
            - null
          description: >-
            Whether the account is a checking or a savings account, or null if
            not provided.
          nullable: true
      required:
        - type
        - bic
        - account_number
        - account_holder_name
        - local_bank_code
        - account_type
      additionalProperties: false
      title: BIC
      example:
        type: bic
        bic: ANZBAU3MXXX
        account_number: '123456789'
        account_holder_name: Acme Sandbox Pty Ltd.
        local_bank_code: '012003'
        account_type: checking
    CryptoWalletFinancialAddress:
      type: object
      properties:
        type:
          type: string
          description: Discriminator for crypto wallet financial address.
          enum:
            - crypto_wallet
        address:
          type: string
          description: Wallet address on the specified blockchain.
        blockchain:
          type: string
          enum:
            - bitcoin
            - ethereum
            - solana
            - polygon
            - bitcoin_testnet4
            - ethereum_sepolia
            - solana_devnet
            - polygon_amoy
          description: Blockchain network for the crypto wallet.
          example: ethereum_sepolia
      required:
        - type
        - address
        - blockchain
      additionalProperties: false
      title: Wallet
      example:
        type: crypto_wallet
        address: '0x1111111111111111111111111111111111111111'
        blockchain: ethereum_sepolia
  securitySchemes:
    BearerAuth:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Bearer token for authentication with Augustus Banking API

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.