---
title: "Request payment details from a counterparty"
method: POST
path: "/counterparties/{id}/invite"
tags: ["Counterparties"]
---

# Request payment details from a counterparty

`POST /counterparties/{id}/invite`

Sends the first invite, resends a pending one, or replaces the outstanding ask.

## Path parameters

- `id` string, required

## Request body

- object
  - `methods` object, required
    - `bank` boolean, required
    - `wallet` boolean, required

## Response `200`

Counterparty with its invite state

- object
  - `counterparty` object, required
    - `id` string, required
    - `name` string, required
    - `email` string
    - `createdAt` string, date-time, required
    - `rails` union[], required
      - union
        - object
          - `id` string, required
          - `counterpartyId` string, required
          - `createdAt` string, date-time, required
          - `source` 'platform' | 'counterparty', required
          - `type` 'bank', required
          - `bankName` string, required
          - `routingNumber` string, required
          - `accountNumber` string, required
          - `accountType` 'checking' | 'savings'
          - `address` string
          - `addressStreet` string
          - `addressCity` string
          - `addressState` string
          - `addressPostalCode` string
          - `addressCountry` string
          - `providerExternalAccountId` string
        - object
          - `id` string, required
          - `counterpartyId` string, required
          - `createdAt` string, date-time, required
          - `source` 'platform' | 'counterparty', required
          - `type` 'wallet', required
          - `walletAddress` string, required
          - `network` 'base' | 'base-sepolia' | 'arc' | 'solana', required
    - `status` 'ready' | 'awaiting_details', required
    - `invite` object
      - `state` 'outstanding' | 'expired', required
      - `expiresAt` string, required
      - `methods` object, required
        - `bank` boolean, required
        - `wallet` boolean, required

---

[API](https://skmtc.dev/catena/apis/catena-api.md) · [All operations](https://skmtc.dev/catena/apis/catena-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/catena/catena-api/revisions/4cf035dc4837/schema)