---
id: pull-data-endpoint
title: "Pull Data Endpoint"
description: "The Pull Data endpoint allows a Data Using Service to Pull Data according to a  specific Data Disclosure Agreement record signed by themselves and a Data  Source, either anonymously or for a specific individual."
sidebar_label: "Pull Data Endpoint"
hide_title: true
hide_table_of_contents: true
api: eJzlVs1uGzcQfpUBTwmwXilOelkEQZ3YLdQUrRE56MEx4NFytMuYSzIkV7Iq6NYn6aP1SYohVz9Wfgv01F6EFckZznyc+b5ZC0mh9spFZY2oxFVLcNlrDecYEchIZ5WJgFrbZQDMy2+DMg1MyS9UTRDtgQXWtfWSt6MFBAiOajVXdd49V6HWNvSe4KzxRB2ZCJ7YBIJqDEmYrSC21AXSCwqARm4vhantfU0FkIoteUBjzaqzfdArsB7m1gPur1NGqoWSPerynRGF8PShpxBfWrkS1VrU1kQykT/ROa1q5PxH7wODsBahbqlD/oorR6ISdvae6igK4bx15KOiwLsSI+5z2qX0JmU0kQcOQvTKNKI4gvvzqGQfMDkXm0Lss/kWp5Pd6WS+ydkrT1JU11+N+WazySbBWRNynqfjcUr3wTXTvq4phHmv4Sx9wZW9IwOeNGEgUfxbKGPynpx/PfkhlJhCiRZmBH0gCciQhlRCqXLJi80mp/ps/OQf1cQhmuS99a+s5HTT9/lBNDfFVzLbW+/zUiZSQ5793WPnNInq2Xi8+YT7T2CxMxEvUYIyro/g0GNHcZvwMWBvDfaxtV79TlIUoiWU5Dk6Pvpdfvj/KTQTE8kb1BBSwUC65gijTSEC1b1XcSWq67U4c+o18efNhnPEJjAW00xuu24LDEBHsbVSVMLZkADA2IpKjBZPRyFz64ib9SQ4rGnkeq1P+L/gGzmekC48IhTq7BCuKETvtahEG6ML1WgkqbMn6FSpGo8mlsqKTfFRV0dsmL4/4yPk7WM3N3sUplwM+Q23WOweA/MCExr7TDCKQhjsePdsqMNUXB839uUE7mgFXK1k4lCDJbBiLVD3BHbO0gG3D/zcQr4Guj5EZgPnaa7uScJSxRZuc4xwC4+MjZQcRI9KJwwY+McFUNmUR24rGAyfr2zvGY6TO1q9uC2Zrl8SevJ8nnOfpX8/WN9hFJX46berL5OWwxC24WVPQ8ygDDwIAnYIpg5kDPNlYtdd/G5JArhX3+xF8GLbDd8gYvseeqhD2/UkUHO7JQqsE1FQh4orJ/TOWR+/31fL7sHVj/ulh2V2WKFHWO2M4NFff/z5GBSPJdMlSRVakGlqua9bNA2l6WFBngeCjNfQVuC8XShJvoRJZHkIEEjPT4JdkCfVGFCSSyyuisEeZ5qg9pSWUYcCEKRqVEQNS9SaYrosWK0kOCshUt0aq22jKBRABmepohAMLUHTgjSXKxNaYj2cKa3iKs87fbQdRj5e285phaamXA4pPU9Nr1M+gSsCYd5rzX0hVUxxdmgM+VIUQquaTEivvO0xh3VLcFqOP8J8uVyWmLZL65vRYBtGP09eXfwyvThhm00hoor6weMBd6a0dc9Vs+1dpqf8Xqfj02fl0/IJ2zLRdWgO4tlPjhfDrHncHAfq85+dTodmjXQfR06jMgxWep31oArXYvF0IH5Vs6LulYGVY6cNN4VoWU2qa7FezzDQW683G17+0JNPulSIBfpU0UmltnKWxOSO6Vq8yoCfXHFYfFz3mb2PpJ/VI1swgbn4xbOHgnf565RJcDZM412SeeFxyZM6LkUl3ol3QhTCpiJIYpLW10KjaXps+Hz2y+SGA9XuZeYuyczwwZltt8zqIMpjxcnJ8C+n9kmT51ztr2n1Ync873zWYMfR+TS/LY/YfwPJFbXE
sidebar_class_name: "post api-method"
info_path: docs/datamarketplace-individual-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"}>Pull Data Endpoint</h1>

<MethodEndpoint method={"post"} path={"/v3/service/data-space/pull-data"}></MethodEndpoint>



The Pull Data endpoint allows a Data Using Service to Pull Data according to a  specific Data Disclosure Agreement record signed by themselves and a Data  Source, either anonymously or for a specific individual.


## Request

<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"dataDisclosureAgreementRecordId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Data Disclosure Agreement Record ID"}}></SchemaItem><SchemaItem collapsible={false} name={"individualId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Individual ID"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Successful Access Token release

</div><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={"accessToken"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Access token to be used at Resource Server"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"accessToken\": \"string\"\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>