---
id: read-pull-data-record
title: "Read Pull Data Record"
description: "Reads a specific Pull Data Record."
sidebar_label: "Read Pull Data Record"
hide_title: true
hide_table_of_contents: true
api: eJzlV8FuGzcQ/ZUBTwmwlhzHvQhBUCdOAzdFEVgOeggMeLwc7TLmkgzJlawIuvVL+mn9kmLIlbTSOoGD5pYcnN0V53HmzfDNcCUkhdIrF5U1YiIuCWUAhOCoVDNVwvtWazjHiHBJpfVyJArh0GNDkXwQk4+rA4SLc7AziDUNTOGW4oLIAOavU9v6kgCNzO8fgjIVTMnPVUmiEIrhHMZaFMJgQ/zWas1rM+CFFIXw9LlVnqSYRN9SIUJZU4NishJx6dgmRK9MJdbra14cnDWBAv9+cnzM/+27P3DaE/I2pTWRTGQDdE6rEtlg/Cmw1aq3q/PWkY8q77HvcM8re/uJyiiKAf9pUzsD7PHHMVLg1fvoSg4D+HH8H/BXCIkRz1UotQ2tp7PKEzVk4hU1TmOkS5qroKy5+KZXaasdCmxhYIMDGyCINUaQNFOGAvDusMAAzClJwAqVSaQ81tFMw/91syPzYSfZFLdLN4RvAb+bcmNNSUM/L9FI2+glVGTIYyQJeeUDEKUnXnAWhzBXqqEQsXFfLZlkzIu3wMpERo32jswDiDXBWVlSCHDFK6ANJGFmfcoaB8u5Gbq57h/kj1zY31Nuj8/4htE+LZtgrtf8rxA1oUzathKv86k/ukrerobiks5/IegeG6f5w0Ac1odHvI8JeS+R9j09fsbIj1aaPmHkvfWvreTI0vN5b8/rYqA6+zqys95Fpkykinw/uNPj4/UD8AOp7fPxCiUo49oI264hOp73aflgsI219eoLcZp2ScjUnP7E1FxSyLphbISZbc2QoF9yL/tJCbowkbxBDYH8nDykbQ44WhciUNl6FZdpajlz6h3x4/W6WIlXhJ78WRvr9IWjxorHGzFVlSG50//AlDQUayvFRFSUGOEhZSLG8+fj0pqZqsasR0fBYUljFr6j9O6TGo1Xh1PMWrBv7PlDA9U5NbYLTBSi9VpMRB2jC5PxWFJjj9Cpkao8mjhSVnA0+wDTiBUr71cwQv75EOZ6x9eUyyZne8PaNm2YP3TTWidn23ntrDvSmx6y79jZ+wu4oyXwwScTu2odATeROeqWNm3pZg/nplNNaNrAPRacp5m6JwkLFWu4yT7CDTwxNlICiB5V6j4pJU8LoFE1OoCdQGf4Ymlbz3Qc3dHy5c2IJbxfHytxm95+s77BKCbi97+uhrHlJpg6CzgMYeNeRup8BmVgzwnYMpjOKnOYN9u1TM5bapjKzOzm0GOZDj01qDi3oXXO+vjrLp/blKi3u0/7hdCvoYNotkbw5N+//3kKiu8I0wVJFeo8mNF9WaOp8mwzJ8+XhxxRyNMNOG/nSpIfwUXksSBAID07CnZOnlRlQEkugrgsOnu81cQDSPqMOhSAIFWlImpYoNYU02bBaiXBWQmRytpYbStFoQAyeJtyjmBoAZrmpLmgWJySguGt0iouEwi20TYYeXlpG6cVmpJywmSewKtWp3gC5wxh1mrNlStVTH42aAx5vh1pVZIJSQ43p8BhWROcjI4HnC8WixGmn0fWV+PONoz/uHj95s/pmyO24WlLRb2XPOCzI23ZsiRtThcLSM7XyfHJ6ej56BnbOhtig6bnD1/yBqPeYQX3msnjboVdeUa6j2OnUaXRJ0W76gTyo5g/z1epmaq6oS2LJGvogUyKQkwG173rQtQ2RIZarW4x0Aev12v+/Lkln9S8EHP0qXaylqrAz1JMZqgDfSPIJ5ddT3wKP/wOtU/KRjoN62YSOjERohB3rKzDO+76ejuUppDyMhYYF3sAw8mz36jevmGNwk7AduJ9l8S7e2D0B5071PHsAv/ldvOgyQuu0He0fLldnn/5qsFW+fJqpoon8v8A0q/MVA==
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"}>Read Pull Data Record</h1>

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



Reads a specific Pull Data Record.

## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Path Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"ID of the Pull Data Record between a Data Source and Data Using Service","in":"path","name":"pullDataRecordId","required":true,"schema":{"type":"string"}}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Pull Data Record read

</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"}>pullDataRecord</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Record of a Pull Data request

</div><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></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"pullDataRecord\": {\n    \"id\": \"string\",\n    \"dataDisclosureAgreementTemplateRevisionId\": \"string\",\n    \"dataDisclosureAgreementRecordRevisionId\": \"string\",\n    \"nonce\": \"string\",\n    \"token\": \"string\"\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={"404"} value={"404"}><div>

Resource not found

</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>