> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools/global-indexer/indexer-apis.md).

# Indexer APIs

Endpoints for the Guardian Global Indexer service, which provides search and analytics across all Hedera-based Guardian entities including policies, schemas, tokens, DIDs, VCs, VPs, and more.

**Authentication:** Bearer token required for most endpoints (`Authorization: Bearer <token>`)

***

| Method   | Endpoint                                                         | Description                                       | Auth Required |
| -------- | ---------------------------------------------------------------- | ------------------------------------------------- | ------------- |
| `GET`    | `/api/v1/search`                                                 | Full-text search across all indexed entities      | Yes           |
| `GET`    | `/api/v1/entities/did-documents`                                 | Returns all indexed DID documents                 | Yes           |
| `GET`    | `/api/v1/entities/did-documents/{messageId}`                     | Returns a DID document by message ID              | Yes           |
| `GET`    | `/api/v1/entities/did-documents/{messageId}/relationships`       | Returns DID relationships                         | Yes           |
| `GET`    | `/api/v1/entities/vc-documents`                                  | Returns all indexed VC documents                  | Yes           |
| `GET`    | `/api/v1/entities/vc-documents/{messageId}`                      | Returns a VC document by message ID               | Yes           |
| `GET`    | `/api/v1/entities/vc-documents/{messageId}/relationships`        | Returns VC document relationships                 | Yes           |
| `GET`    | `/api/v1/entities/vp-documents`                                  | Returns all indexed VP documents                  | Yes           |
| `GET`    | `/api/v1/entities/vp-documents/{messageId}`                      | Returns a VP document by message ID               | Yes           |
| `GET`    | `/api/v1/entities/vp-documents/{messageId}/relationships`        | Returns VP document relationships                 | Yes           |
| `GET`    | `/api/v1/entities/policies`                                      | Returns all indexed policies                      | Yes           |
| `GET`    | `/api/v1/entities/policies/{messageId}`                          | Returns a policy by message ID                    | Yes           |
| `GET`    | `/api/v1/entities/policies/{messageId}/relationships`            | Returns policy relationships                      | Yes           |
| `GET`    | `/api/v1/entities/schemas`                                       | Returns all indexed schemas                       | Yes           |
| `GET`    | `/api/v1/entities/schemas/{messageId}`                           | Returns a schema by message ID                    | Yes           |
| `GET`    | `/api/v1/entities/schemas/{messageId}/tree`                      | Returns the schema tree                           | Yes           |
| `GET`    | `/api/v1/entities/tokens`                                        | Returns all indexed tokens                        | Yes           |
| `GET`    | `/api/v1/entities/tokens/{tokenId}`                              | Returns a token by token ID                       | Yes           |
| `GET`    | `/api/v1/entities/nfts`                                          | Returns all indexed NFTs                          | Yes           |
| `GET`    | `/api/v1/entities/nfts/{serialNumber}`                           | Returns an NFT by serial number                   | Yes           |
| `GET`    | `/api/v1/entities/topics`                                        | Returns all indexed Hedera topics                 | Yes           |
| `GET`    | `/api/v1/entities/topics/{topicId}`                              | Returns a topic by topic ID                       | Yes           |
| `GET`    | `/api/v1/entities/contracts`                                     | Returns all indexed retirement contracts          | Yes           |
| `GET`    | `/api/v1/entities/contracts/{messageId}`                         | Returns a contract by message ID                  | Yes           |
| `GET`    | `/api/v1/entities/modules`                                       | Returns all indexed modules                       | Yes           |
| `GET`    | `/api/v1/entities/modules/{messageId}`                           | Returns a module by message ID                    | Yes           |
| `GET`    | `/api/v1/entities/tools`                                         | Returns all indexed tools                         | Yes           |
| `GET`    | `/api/v1/entities/tools/{messageId}`                             | Returns a tool by message ID                      | Yes           |
| `GET`    | `/api/v1/entities/roles`                                         | Returns all indexed roles                         | Yes           |
| `GET`    | `/api/v1/entities/roles/{messageId}`                             | Returns a role by message ID                      | Yes           |
| `GET`    | `/api/v1/entities/standard-registries`                           | Returns all indexed Standard Registry accounts    | Yes           |
| `GET`    | `/api/v1/entities/standard-registries/{messageId}`               | Returns a Standard Registry by message ID         | Yes           |
| `GET`    | `/api/v1/entities/standard-registries/{messageId}/relationships` | Returns Standard Registry relationships           | Yes           |
| `GET`    | `/api/v1/entities/registry-users`                                | Returns all indexed registry users                | Yes           |
| `GET`    | `/api/v1/entities/registry-users/{messageId}`                    | Returns a registry user by message ID             | Yes           |
| `GET`    | `/api/v1/entities/formulas`                                      | Returns all indexed formulas                      | Yes           |
| `GET`    | `/api/v1/entities/formulas/{messageId}`                          | Returns a formula by message ID                   | Yes           |
| `GET`    | `/api/v1/entities/formulas/{messageId}/relationships`            | Returns formula relationships                     | Yes           |
| `GET`    | `/api/v1/analytics/search/policies`                              | Returns search results for policies               | Yes           |
| `GET`    | `/api/v1/analytics/compare/policy/original/{messageId}`          | Compares policy changes by message ID             | Yes           |
| `GET`    | `/api/v1/analytics/derivations/{messageId}`                      | Returns policy derivations                        | Yes           |
| `GET`    | `/api/v1/landing`                                                | Returns landing page analytics                    | No            |
| `GET`    | `/api/v1/landing/settings`                                       | Returns Hedera network explorer settings          | No            |
| `GET`    | `/api/v1/landing/network`                                        | Returns the Hedera network name                   | No            |
| `GET`    | `/api/v1/landing/coordinates`                                    | Returns project geo-coordinates                   | No            |
| `POST`   | `/api/v1/landing/data-priority-policy`                           | Adds policy data to the priority loading queue    | Yes           |
| `POST`   | `/api/v1/landing/data-priority-tokens`                           | Adds token data to the priority loading queue     | Yes           |
| `POST`   | `/api/v1/landing/data-priority-topics`                           | Adds topic data to the priority loading queue     | Yes           |
| `POST`   | `/api/v1/landing/data-priority-any/{entityId}`                   | Adds any entity to the priority loading queue     | Yes           |
| `GET`    | `/api/v1/landing/progress`                                       | Returns data loading progress                     | Yes           |
| `POST`   | `/api/v1/entities/update-files`                                  | Refreshes linked files for the selected documents | Yes           |
| `GET`    | `/api/v1/artifacts/files/{fileId}`                               | Downloads a file by ID                            | Yes           |
| `DELETE` | `/api/v1/ipfs/file/{cid}`                                        | Removes a file from IPFS by CID                   | Yes           |

## Endpoints

* [Full-Text Indexer Search](/developer-tools/global-indexer/indexer-apis/full-text-indexer-search.md)
* [Returns DIDs](/developer-tools/global-indexer/indexer-apis/returns-dids.md)
* [Returns DID as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-did-as-per-messageid.md)
* [Returns DID Relationships](/developer-tools/global-indexer/indexer-apis/returns-did-relationships.md)
* [Returns VC Documents](/developer-tools/global-indexer/indexer-apis/returns-vc-documents.md)
* [Returns VC Document as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-vc-document-as-per-messageid.md)
* [Returns VC Relationships](/developer-tools/global-indexer/indexer-apis/returns-vc-relationships.md)
* [Returns VP Documents](/developer-tools/global-indexer/indexer-apis/returns-vp-documents.md)
* [Returns VP Document as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-vp-document-as-per-messageid.md)
* [Returns VP Relationships](/developer-tools/global-indexer/indexer-apis/returns-vp-relationships.md)
* [Returns Policies](/developer-tools/global-indexer/indexer-apis/returns-policies.md)
* [Returns Policy as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-policy-as-per-messageid.md)
* [Returns Policy Relationships](/developer-tools/global-indexer/indexer-apis/returns-policy-relationships.md)
* [Returns Schemas](/developer-tools/global-indexer/indexer-apis/returns-schemas.md)
* [Returns Schema as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-schema-as-per-messageid.md)
* [Returns Schema Tree](/developer-tools/global-indexer/indexer-apis/returns-schema-tree.md)
* [Returns Tokens](/developer-tools/global-indexer/indexer-apis/returns-tokens.md)
* [Returns Token as per Token ID](/developer-tools/global-indexer/indexer-apis/returns-token-as-per-tokenid.md)
* [Returns NFTs](/developer-tools/global-indexer/indexer-apis/returns-nfts.md)
* [Returns NFT as per Serial No.](/developer-tools/global-indexer/indexer-apis/returns-nft-as-per-serial-no..md)
* [Returns Topics](/developer-tools/global-indexer/indexer-apis/returns-topics.md)
* [Returns Topic as per Topic ID](/developer-tools/global-indexer/indexer-apis/returns-topic-as-per-topicid.md)
* [Returns Contracts](/developer-tools/global-indexer/indexer-apis/returns-contracts.md)
* [Returns Contract as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-contract-as-per-messageid.md)
* [Returns Modules](/developer-tools/global-indexer/indexer-apis/returns-modules.md)
* [Returns Module as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-module-as-per-messageid.md)
* [Returns Tools](/developer-tools/global-indexer/indexer-apis/returns-tools.md)
* [Returns Tool as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-tool-as-per-messageid.md)
* [Returns Roles](/developer-tools/global-indexer/indexer-apis/returns-roles.md)
* [Returns Role as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-role-as-per-messageid.md)
* [Returns Standard Registries](/developer-tools/global-indexer/indexer-apis/returns-standard-registries.md)
* [Returns Registry as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-registry-as-per-messageid.md)
* [Returns Registry Relationships](/developer-tools/global-indexer/indexer-apis/returns-registry-relationships.md)
* [Returns Registry Users](/developer-tools/global-indexer/indexer-apis/returns-registry-users.md)
* [Returns Registry User as per Message ID](/developer-tools/global-indexer/indexer-apis/returns-registry-user-as-per-messageid.md)
* [Retrieve the List of Formulas](/developer-tools/global-indexer/indexer-apis/retrieve-the-list-of-formulas.md)
* [Retrieve the Formula by Message ID](/developer-tools/global-indexer/indexer-apis/retrieve-the-formula-by-message-id.md)
* [Retrieve Linked Documents Related to Formula](/developer-tools/global-indexer/indexer-apis/retrieve-linked-documents-which-are-related-to-formula.md)
* [Returns Search Policy Results](/developer-tools/global-indexer/indexer-apis/returns-search-policy-results.md)
* [Comparing the Policy Changes as per ID](/developer-tools/global-indexer/indexer-apis/comparing-the-policy-changes-as-per-id.md)
* [Display the Derivations](/developer-tools/global-indexer/indexer-apis/display-the-derivations.md)
* [Returns Landing Page Analytics](/developer-tools/global-indexer/indexer-apis/returns-landing-page-analytics.md)
* [Returns Hedera Network Explorer Settings](/developer-tools/global-indexer/indexer-apis/returns-hedera-network-explorer-settings.md)
* [Returns Hedera Network](/developer-tools/global-indexer/indexer-apis/returns-hedera-network.md)
* [Returns Project Coordinates](/developer-tools/global-indexer/indexer-apis/returns-project-coordinates.md)
* [Adding Policy Data for Priority Loading](/developer-tools/global-indexer/indexer-apis/adding-policy-data-for-priority-loading.md)
* [Adding Token Data for Priority Loading](/developer-tools/global-indexer/indexer-apis/adding-token-data-for-priority-loading.md)
* [Adding Topic Data Priority Loading](/developer-tools/global-indexer/indexer-apis/adding-topic-data-priority-loading.md)
* [Adding Document to Data Priority Loading](/developer-tools/global-indexer/indexer-apis/adding-document-to-data-priority-loading.md)
* [Returning Topic Data Priority Loading Progress](/developer-tools/global-indexer/indexer-apis/returning-topic-data-priority-loading-progress.md)
* [Returns Data Loading Progress Result](/developer-tools/global-indexer/indexer-apis/returns-data-loading-progress-result.md)
* [Attempts to Refresh Linked Files for the Selected Documents](/developer-tools/global-indexer/indexer-apis/attempts-to-refresh-linked-files-for-the-selected-documents.md)
* [Download File by ID](/developer-tools/global-indexer/indexer-apis/download-file-by-id.md)
* [Removes a File from IPFS by CID](/developer-tools/global-indexer/indexer-apis/removes-a-file-from-ipfs-by-cid.md)
