IPNS

Resolve IPNS

Resolves an IPNS name to its current target CID.

Looks up the current CID that an IPNS name points to. Returns the resolved CID, validity information, and sequence number.

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/ipns/resolve/{name}
Auth: none declared

namestring required

IPNS name (peer ID). Example: 12D3KooW...

check_routingstring

Whether to verify routing through the IPFS network. 1 = verify (queries DHT), 0 = local only. Default: 0

IPNS resolve result

expiredboolean required

expiresstring date-time required

namestring required

pathstring required

sequenceinteger required

valuestring required

Sep 20, 202606e0fa4f446e Revision changes
- info
  added the non-success response with the status
Jul 18, 2026b97dd0465ab3 Revision changes
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- breaking
  the response's property type changed from string to object for status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status