List Issuers

Returns all active issuers (branches / issue points) belonging to the authenticated tenant.

GET /v1/issuers

Authentication

Authorization: Bearer <api-key>

Response

200 OK

{
  "ok": true,
  "issuers": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "ruc": "1234567890001",
      "businessName": "ACME S.A.",
      "tradeName": "ACME",
      "branchCode": "001",
      "issuePointCode": "001",
      "branchAddress": "Av. Amazonas 123",
      "certFingerprint": "AA:BB:CC:...",
      "certExpiry": "2027-01-01T00:00:00.000Z",
      "canIssue": true
    }
  ]
}

Issuer fields

Field	Description
id	Issuer UUID — pass as X-Issuer-Id on document requests
ruc	Taxpayer RUC
businessName	Legal business name
tradeName	Trade name (null if not set)
branchCode	3-digit SRI branch code
issuePointCode	3-digit SRI issue point code
branchAddress	Branch address (null if not set)
certFingerprint	Certificate fingerprint (null if no cert loaded)
certExpiry	Certificate expiry date (null if no cert loaded)
canIssue	false if the issuer was paused via Pause/Resume Issuing

Errors

Code	Status	When
UNAUTHORIZED	401	Missing or invalid API key