---
title: "API reference — Anis Developers"
description: "Every route of the Anis Partner API: what it does, what it needs and what it returns."
url: https://developers.anis.ly/reference/
language: en
---

> Every page of this documentation: https://developers.anis.ly/llms.txt

# API reference

Every route of the Anis Partner API, generated from the contract the gateway publishes. Each page says what the route is for, the permission it needs, how it is signed, the fields it takes and returns, and every refusal it can give.

## Your application

|   |   |   |
| --- | --- | --- |
| GET | [Read your profile](https://developers.anis.ly/reference/read-profile.md)  — `/v1/profile` | `profile:read` |

## Wallets

|   |   |   |
| --- | --- | --- |
| GET | [List wallets](https://developers.anis.ly/reference/list-wallets.md)  — `/v1/wallets` | `wallets:read` |
| GET | [Read a wallet](https://developers.anis.ly/reference/read-wallet.md)  — `/v1/wallets/{walletId}` | `wallets:read` |

## Catalogue

|   |   |   |
| --- | --- | --- |
| GET | [List catalogue categories](https://developers.anis.ly/reference/list-categories.md)  — `/v1/wallets/{walletId}/catalog/categories` | `catalogue:read` |
| GET | [List subcategories of a category](https://developers.anis.ly/reference/list-subcategories.md)  — `/v1/wallets/{walletId}/catalog/categories/{categoryId}/subcategories` | `catalogue:read` |
| GET | [Read a subcategory](https://developers.anis.ly/reference/read-subcategory.md)  — `/v1/wallets/{walletId}/catalog/subcategories/{subcategoryId}` | `catalogue:read` |
| GET | [List cards for sale](https://developers.anis.ly/reference/list-cards.md)  — `/v1/wallets/{walletId}/catalog/subcategories/{subcategoryId}/cards` | `catalogue:read` |

## Orders

|   |   |   |
| --- | --- | --- |
| POST | [Place an order](https://developers.anis.ly/reference/create-order.md)  — `/v1/wallets/{walletId}/orders` | `orders:create` |
| GET | [Read an order](https://developers.anis.ly/reference/read-order.md)  — `/v1/orders/{operationId}` | `orders:read` |

## Owned cards

|   |   |   |
| --- | --- | --- |
| GET | [List owned cards](https://developers.anis.ly/reference/list-owned-cards.md)  — `/v1/wallets/{walletId}/cards` | `cards:read` |
| GET | [Read an owned card](https://developers.anis.ly/reference/read-owned-card.md)  — `/v1/wallets/{walletId}/cards/{soldCardId}` | `cards:read` |
| POST | [Reveal a card](https://developers.anis.ly/reference/reveal-card.md)  — `/v1/wallets/{walletId}/cards/{soldCardId}/reveal` | `cards:reveal` |
| POST | [Reveal an invoice](https://developers.anis.ly/reference/reveal-invoice.md)  — `/v1/wallets/{walletId}/invoices/{invoiceId}/cards/reveal` | `cards:reveal` |

## Diagnostics

|   |   |   |
| --- | --- | --- |
| POST | [Check your signature](https://developers.anis.ly/reference/check-signature.md)  — `/v1/diagnostics/signature` | `diagnostics:use` |

## Enrolment

|   |   |   |
| --- | --- | --- |
| GET | [Read an invitation](https://developers.anis.ly/reference/read-invitation.md)  — `/v1/enrollments/{invitationId}` | None |
| POST | [Submit a public key](https://developers.anis.ly/reference/submit-key.md)  — `/v1/enrollments/{invitationId}/keys` | None |
| POST | [Prove you hold the key](https://developers.anis.ly/reference/submit-proof.md)  — `/v1/enrollments/{invitationId}/proof` | None |
| GET | [Read enrolment status](https://developers.anis.ly/reference/read-enrollment-status.md)  — `/v1/enrollments/{invitationId}/status` | None |

## Anis signing keys

|   |   |   |
| --- | --- | --- |
| GET | [Anis’s public signing keys](https://developers.anis.ly/reference/signing-keys.md)  — `/.well-known/partner-signing-keys.json` | None |