Skip to content

Get Account

Retrieve detailed account information by ID. Returns the account with associated profile info, emails, and wallet addresses.

Endpoint

GET https://api.recoupable.com/api/accounts/{id}

Parameters

NameTypeRequiredDescription
idstringYesThe unique identifier of the account

Request Examples

cURL
curl -X GET "https://api.recoupable.com/api/accounts/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json"

Response Format

{
  "status": "success",
  "account": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Organization",
    "image": "https://example.com/avatar.jpg",
    "instruction": "Custom AI instructions for this account",
    "knowledges": [
      {
        "url": "https://storage.example.com/file.txt",
        "name": "knowledge-base.txt",
        "type": "text/plain"
      }
    ],
    "email": "user@example.com",
    "wallet_address": "0x1234567890abcdef..."
  }
}
{
  "status": "error",
  "message": "Account not found"
}

Response Properties

PropertyTypeDescription
statusstringStatus of the request ("success" or "error")
accountobjectThe account details
account.idstringUnique identifier (UUID)
account.namestringAccount display name
account.imagestring | nullProfile image URL
account.instructionstring | nullCustom AI instructions
account.knowledgesarray | nullKnowledge base files attached to this account
account.emailstring | nullPrimary email address
account.wallet_addressstring | nullConnected wallet address
messagestringError message (only present if status is "error")