---
title: "Get DataStore resource metadata"
method: GET
path: "/datastore_info"
tags: ["DataStore"]
---

# Get DataStore resource metadata

`GET /datastore_info`

Retrieve field definitions, type information, and size/count metadata for a DataStore resource.

## Query parameters

- `resource_id` string, required

## Response `200`

Successful response.

- DatastoreInfoResponse
  - `help` string, required — URL to the API documentation for this action.
  - `success` boolean, required — Whether the request succeeded.
  - `result` DatastoreInfoResult, required
    - `meta` DatastoreResourceMeta
      - `aliases` string[], required — List of aliases defined for this resource.
      - `count` integer, nullable — Total number of rows in the resource table.
      - `db_size` integer, nullable — Total size of the DataStore database in bytes (all tables, not just this resource).
      - `id` string, required — The resource ID.
      - `idx_size` integer, nullable — Size of indexes on this resource table in bytes.
      - `size` integer, nullable — Size of this resource table in bytes.
      - `table_type` 'BASE TABLE' | 'VIEW' | 'FOREIGN' | 'LOCAL TEMPORARY', nullable — PostgreSQL table type for this resource.
    - `fields` object[], required — List of field descriptor objects. Each contains `id`, `type`, and optionally `schema` with index and uniqueness information.

## Other responses

- `403` — Forbidden — API token is missing or invalid. Authentication is required for all DataStore requests, including public resources.
- `404` — Not Found — the resource_id does not exist in the DataStore.
- `409` — Conflict — Validation Error. The request parameters or SQL were invalid (e.g. missing required parameter, non-SELECT SQL, malformed query, or wrong parameter type).
- `429` — Too Many Requests — rate limit exceeded.
- `500` — Internal Server Error — unexpected server-side failure.

---

[API](https://skmtc.dev/humdata/apis/hdx-apis.md) · [All operations](https://skmtc.dev/humdata/apis/hdx-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humdata/hdx-apis/revisions/cc1970bc392c/schema)
