GET/accounts/code/{code}

Get a specific account by its code

Display the specified account by code

Parameters

Name	In	Type	Description
`code`required	path	string	Account code (customer-defined identifier)

Responses

200Successful operation

{
  "success": true,
  "data": {
    "id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
    "ledger_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
    "code": "1000",
    "name": "Cash",
    "type": "asset",
    "category": "system",
    "normal_balance": "debit",
    "balance": "1000.00",
    "is_active": true,
    "is_system": false,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-15T10:30:00Z"
  }
}

401Unauthenticated

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

403Forbidden

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

404Account not found

{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

Examples

curl https://ledga.io/api/v1/accounts/code/{code} \
  -H "Authorization: Bearer sk_xxxxxxxx_your_secret"

use Ledga\Api\LedgaClient;

$ledga = new LedgaClient('sk_xxxxxxxx_your_secret');

$account = $ledga->accounts->getByCode('1000');

← All endpoints