Skip to main content
PUT
/
partner
/
data-requests
/
{dataRequestId}
Fulfill a user data request
curl --request PUT \
  --url https://m2m-backend-qa.up.railway.app/partner/data-requests/{dataRequestId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "referenceId": "user-12345",
  "userData": {
    "name": {
      "firstName": "Juan",
      "secondName": "Carlos",
      "lastName": "Pérez",
      "secondLastName": "García"
    },
    "idNumber": "GAPA900515HDFRRL09",
    "idType": "CURP",
    "dob": "1990-05-15",
    "paymentMethod": {
      "type": "bank_account",
      "cash": {
        "provider": "<string>",
        "reference": "<string>"
      }
    },
    "idImage": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }
}
'
{
  "success": true,
  "data": {
    "dataRequestId": "dr_acme_a1b2c3d4e5f6",
    "status": "fulfilled",
    "linkId": "link_acme_a1b2c3d4e5f6",
    "message": "User data received and merged successfully",
    "fulfilledAt": "2026-02-10T15:00:00.000Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Your partner API key. Use m2m_test_* keys for the sandbox environment.

Path Parameters

​
dataRequestId
string
required

The data request ID received in the user.data_request webhook payload

Example:

"dr_acme_a1b2c3d4e5f6"

Body

application/json
​
referenceId
string
required

Reference ID of the user in your system. Must match the referenceId associated with the data request for validation.

Example:

"user-12345"

​
userData
object
required

User data to fulfill the request. Provide only the fields that were requested in the user.data_request webhook payload. The data will be merged with existing user data on the associated magic link.

Response

Data request fulfilled — user data received and merged successfully

​
success
boolean
required
Example:

true

​
data
object
required