---
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: eJzlVs1uGzcQfpXBnhJAWim2ezGCoP5robZog8hGD44BU7ujFWOKZEmuZFXQrU/SR+uTdIZc7UpyHKdATy0MC1ySM5z5+M03XGcl+sJJG6TR2Wl2PUN4XysFlyIIQF1aI3UAoZRZehBp+sZLXcEY3UIWCMHsWIiiMK7kZZoWAN5iIaeySKuX0hfK+NohnFUOcY7k2yGbgJeVxhImKwgznHtUC6QDdbk9FMamdgX2ACVtcLRk9Gpuaq9WYBxM6V90x0ldyoUsa6HyjzrrZQ5/q9GHc1OustN1Vhgd6GweCmuVLATnP/jkGYR15gsKQfAorCwSLGbyCYtAfqwzFl2Q6Hm1pMC6nNqUPsSMRuWOAx8cgUIO9uF+HpXkA0aX2aaXddl8jdNRuzuab1L20iHZ3r4Y891mk0y8NdqnPI+Gw5ju3jHjuijQ+2mt4CyO4No8oKb7VCg8Ulj/Esoieo/OX06+CSXEUIiDE4TaE68EQ+ojhSJz0WWbTUr1ZPjmH3FiF010zrgLU3K6cXy5E81d74XMOusuLyo3rCg68vco5lbR3MlwuPmM+89g0Zpk56KkIrB1ACucmGPYJnwI2I0WdZgZJ3+njHrZDEWJjqPjrd+ki/+fQjOi85ymMvKRMBCPOcCIjDwWtZOBhOV2nZ1Z+SPy8G7DOYrKMxbjJG5ttXkGgE6eGYIqs8ZHAESY0ddgcTzwSVsHXKx9bwUNLWlsn78zPpHj8fHAA0HBuWnCpX21UzQ3C8H608GgpLW+sDKXlRM65NKQtjypagqZ5fsZHz4tH7q561AYMxnSHW6xaC9DpAkWNPYZYaQvTZfApdvwMJLraWG/H8EDroDZSgg2HMyBO9ZCqBrBTLl1wP2en3tIx8C89oHVwDqcyke6jCX1EdocQ4J7eKVNwOggOCFVxICBf00dJ6/yA7en0Bi+XZGmMBx9Cu7dfc5yfY7CoeP9nPskfn1n3FxQBWU//Hr9ZdGywvtteMlTEzORFvaCgBbBWIGMYTosa6uL7y22AK7VD10TvNpWw1c0sa6G9vvQdj42qKnZCoUoolCQIkhmjq+tNS5827GlvXD5fTe1T7Ndhh5g1RrBq7/++PM1SH6WjJdYSj+DMr5aHouZ0BXG1wORmB8ECa+mrAhPQ2mgy2EUuD14WlHTvje0G6lUgRaJYmHVa+zFRCEUJGw8LZTv0ZmlrGQgcVjS4whDPMwbJUuwpoSAxUwbZSqSMyKQJgfMKAEal6BwgYrpyoIWVU9MiHFhld47dTBEFd5eGLokKTSFHOkQ03NY1Srm45kRAqgDK66LksLhOOdCa8qNQCWlRurhfB3bGiNKE8WP8uETzJfLZS7icm5cNWhs/eCn0cXVz+OrPtvQbRAsau/ygCuzNEXNrNnWLstTuq+j4dFJfpy/YVsWOopuJ57u5XjVvDUPi2On+/xnX6dNsQZ8DAOrBKnjprmdddMVbrPFcSP8lBVj1HYG7hxtbyAhnnE3IYP1ekLPsBunNhueptJ3sS/R5QgXGR271LadxWbywHKdXSTA+9ccFm8ndY3qfdD6uXskCxYwG764d7fhvf9lzCI4aV7j89jmMyeW/FKn39PsI/3Rh4kkiM0kzq8zRZVdi4r3J78sbqKR2q7NPMQ20ww4s+2SXu1EedhxUjL8y6l91uQts52E/127Pa08a9BqdNrNd8tP7L8ByRW1xA==
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>