---
id: list-pull-data-records
title: "List Pull Data Records"
description: "Lists Pull Data Records, optionally filtered by Data Disclosure Agreement  Template (Revision ID) and/or Data Disclosure Agreement Record (Revision ID)."
sidebar_label: "List Pull Data Records"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/datamarketplace-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>List Pull Data Records</h1>

<MethodEndpoint method={"get"} path={"/v3/config/data-space/pull-data-records"}></MethodEndpoint>



Lists Pull Data Records, optionally filtered by Data Disclosure Agreement  Template (Revision ID) and/or Data Disclosure Agreement Record (Revision ID).


## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Query Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"Number of records to skip for pagination.","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"name":"limit","in":"query","description":"Maximum number of records to return per page.","required":false,"schema":{"type":"integer","default":10}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"description":"Filter by Data Disclosure Agreement Template Revision ID","in":"query","name":"dataDisclosureAgreementTemplateRevisionId","required":false,"schema":{"type":"string"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"description":"Filter by Data Disclosure Agreement Record Revision ID","in":"query","name":"dataDisclosureAgreementRecordRevisionId","required":false,"schema":{"type":"string"}}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Pull Data Records listed

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}><li className={"schemaItem"}><summary style={{}}><strong>Content-Type</strong><span style={{"opacity":"0.6"}}> json</span></summary><div><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Content-Type header

</div></div></li></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>pullDataRecords</strong><span className={"openapi-schema__name"}> object[]</span></span></summary><div style={{"marginLeft":"1rem"}}><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"ID of the Pull Data Record between a Data Source and Data Using Service","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"dataDisclosureAgreementTemplateRevisionId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"ID of the Data Disclosure Agreement Template Revision that defines data was pulled against","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"dataDisclosureAgreementRecordRevisionId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"ID of the Data Disclosure Agreement Record Revision that defines the agreement between the Data Source and Data Using Service","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"nonce"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"Randomly generated nonce","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={true} schemaName={"int"} qualifierMessage={undefined} schema={{"description":"Timestamp of the Pull Data Record creation","type":"int"}}></SchemaItem><SchemaItem collapsible={false} name={"token"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"The Access Token used for pulling data","type":"string"}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>pagination</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"currentPage"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Current page number","example":1}}></SchemaItem><SchemaItem collapsible={false} name={"totalItems"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Total number of items available","example":25}}></SchemaItem><SchemaItem collapsible={false} name={"totalPages"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Total number of pages based on limit","example":3}}></SchemaItem><SchemaItem collapsible={false} name={"limit"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Number of items per page","example":10}}></SchemaItem><SchemaItem collapsible={false} name={"hasPrevious"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates if there's a previous page","example":false}}></SchemaItem><SchemaItem collapsible={false} name={"hasNext"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates if there's a next page","example":true}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"pullDataRecords\": [\n    {\n      \"id\": \"string\",\n      \"dataDisclosureAgreementTemplateRevisionId\": \"string\",\n      \"dataDisclosureAgreementRecordRevisionId\": \"string\",\n      \"nonce\": \"string\",\n      \"token\": \"string\"\n    }\n  ],\n  \"pagination\": {\n    \"currentPage\": 1,\n    \"totalItems\": 25,\n    \"totalPages\": 3,\n    \"limit\": 10,\n    \"hasPrevious\": false,\n    \"hasNext\": true\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

Unauthorized

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

Internal server error

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>