> For the complete documentation index, see [llms.txt](https://docs.termina.technology/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.termina.technology/documentation/open-source-contributions/modules/data-anchor/indexing-data/getting-blobs/get_blobs_by_namespace.md).

# get\_blobs\_by\_namespace

## Retrieves all blobs for a namespace within a time range.

> \- If \`start\` and \`end\` fields are omitted, then the endpoint will retrieve the blobs that correspond to the namespace across all time.\
> \- Returns an empty list if no blobs were found.\
> \- Returns an error if there was a database or RPC failure.\
> \
> A namespace can be thought of as a human-readable ID for a \*blober\* account so that callers don’t need to work with the public key directly. See the \[predefined naming convention]\(<https://docs.termina.technology/documentation/network-extension-stack/modules/data-anchor/indexing-data>) for how to structure the namespace so that the indexer is able to group \*blobs\* correctly.<br>

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"tags":[{"name":"Blobs","description":"Methods for retrieving raw blob data"}],"servers":[{"url":"https://devnet.data-anchor.termina.technology","description":"Devnet endpoint"},{"url":"https://mainnet.data-anchor.termina.technology","description":"Mainnet endpoint"}],"paths":{"/":{"post":{"tags":["Blobs"],"operationId":"getBlobsByNamespace","summary":"Retrieves all blobs for a namespace within a time range.","description":"- If `start` and `end` fields are omitted, then the endpoint will retrieve the blobs that correspond to the namespace across all time.\n- Returns an empty list if no blobs were found.\n- Returns an error if there was a database or RPC failure.\n\nA namespace can be thought of as a human-readable ID for a *blober* account so that callers don’t need to work with the public key directly. See the [predefined naming convention](https://docs.termina.technology/documentation/network-extension-stack/modules/data-anchor/indexing-data) for how to structure the namespace so that the indexer is able to group *blobs* correctly.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetBlobsByNamespaceRequest"}}}},"responses":{"200":{"description":"RPC success with blob data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcResponse_GetBlobsByNamespace"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"schemas":{"GetBlobsByNamespaceRequest":{"allOf":[{"$ref":"#/components/schemas/RpcRequestBase"},{"type":"object","properties":{"params":{"$ref":"#/components/schemas/GetBlobsByNamespaceParams"}}}]},"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request identifier"},"jsonrpc":{"type":"string","enum":["2.0"],"description":"JSON-RPC version"},"method":{"type":"string","description":"RPC method name"}}},"GetBlobsByNamespaceParams":{"type":"object","required":["namespace"],"properties":{"namespace":{"type":"string","description":"Namespace identifier (e.g. \"home.alice.cloud\")"},"start":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"},"end":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"}}},"RpcResponse_GetBlobsByNamespace":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"string"},"result":{"$ref":"#/components/schemas/GetBlobsByNamespaceResult"},"error":{"$ref":"#/components/schemas/RpcError"}}},"GetBlobsByNamespaceResult":{"type":"array","description":"Nested blob data (`Vec<Vec<u8>>`); empty if none","items":{"type":"array","items":{"type":"integer","format":"int32"}}},"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}},"responses":{"BadRequest":{"description":"Invalid request payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcError"}}}},"ServerError":{"description":"Internal indexer error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcError"}}}}}}}
```

## The RpcRequestBase object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request identifier"},"jsonrpc":{"type":"string","enum":["2.0"],"description":"JSON-RPC version"},"method":{"type":"string","description":"RPC method name"}}}}}}
```

## The GetBlobsByNamespaceParams object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"GetBlobsByNamespaceParams":{"type":"object","required":["namespace"],"properties":{"namespace":{"type":"string","description":"Namespace identifier (e.g. \"home.alice.cloud\")"},"start":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"},"end":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"}}}}}}
```

## The GetBlobsByNamespaceRequest object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"GetBlobsByNamespaceRequest":{"allOf":[{"$ref":"#/components/schemas/RpcRequestBase"},{"type":"object","properties":{"params":{"$ref":"#/components/schemas/GetBlobsByNamespaceParams"}}}]},"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request identifier"},"jsonrpc":{"type":"string","enum":["2.0"],"description":"JSON-RPC version"},"method":{"type":"string","description":"RPC method name"}}},"GetBlobsByNamespaceParams":{"type":"object","required":["namespace"],"properties":{"namespace":{"type":"string","description":"Namespace identifier (e.g. \"home.alice.cloud\")"},"start":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"},"end":{"type":"string","format":"date-time","description":"ISO timestamp, inclusive (optional)"}}}}}}
```

## The GetBlobsByNamespaceResult object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"GetBlobsByNamespaceResult":{"type":"array","description":"Nested blob data (`Vec<Vec<u8>>`); empty if none","items":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}
```

## The RpcError object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}}}}
```

## The RpcResponse\_GetBlobsByNamespace object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_blobs_by_namespace","version":"0.1.0"},"components":{"schemas":{"RpcResponse_GetBlobsByNamespace":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"string"},"result":{"$ref":"#/components/schemas/GetBlobsByNamespaceResult"},"error":{"$ref":"#/components/schemas/RpcError"}}},"GetBlobsByNamespaceResult":{"type":"array","description":"Nested blob data (`Vec<Vec<u8>>`); empty if none","items":{"type":"array","items":{"type":"integer","format":"int32"}}},"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}}}}
```