---
title: "Every XLS-70 credential an account holds (free, live)"
method: GET
path: "/api/credentials/account"
tags: ["Credentials"]
---

# Every XLS-70 credential an account holds (free, live)

`GET /api/credentials/account`

## Request

- Base URL: `https://www.xrplhub.io`
- URL: `https://www.xrplhub.io/api/credentials/account`
- Auth: none required

Get every credential naming this address as Subject — issuer, type, whether it's been accepted, whether it's expired, and its expiry date. Live against a validated mainnet ledger on every call, deliberately not cached: this is the endpoint to check before trusting a counterparty's claimed credential. Free, no signup. Default is an owner-directory walk, bounded at ~20s; for an exchange-scale account it may return coverage:"partial" / complete:false. Pass &issuer= (and &type= unless it's XRPLHub's issuer) for a direct ledger lookup that is always fast and always complete.

## Query parameters

- `address` string, required
- `issuer` string
- `type` string

## Response `200`

Every credential held by this address.

- object
  - `address` string
  - `source` 'live'
  - `lookup` 'owner-walk' | 'targeted'
  - `coverage` 'complete' | 'partial'
  - `complete` boolean
  - `warning` string, nullable
  - `count` integer
  - `credentials` object[]
    - `issuer` string
    - `credentialType` string
    - `credentialTypeHex` string
    - `accepted` boolean
    - `expired` boolean
    - `expirationISO` string, date-time, nullable
    - `uri` string, nullable

## Other responses

- `400`: Missing or invalid address.

---

[API](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions.md) · [All operations](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/llms.txt) · [OpenAPI document](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/revisions/a5d4e13aff32?raw)