# # ForCreaitors API Documentation
\---
\## Overview
The ForCreaitors API is built on HTTPS and returns JSON responses. All endpoints require authentication via a Bearer token passed in the \`Authorization\` header.
\*\*Base URL\*\*
\`\`\`
\`\`\`
\*\*Authentication\*\*
All requests must include:
\`\`\`
Authorization: Bearer YOUR\_TOKEN
\`\`\`
\---
\## Data Portability API (DTI)
ForCreaitors is applying to be a registered participant in the Data Transfer Initiative (DTI) Trust Registry. Our data portability endpoints allow creators to transfer their data from third-party platforms directly into ForCreaitors in a secure, standardized way.
\---
\### POST /api/dti/transfer
Receives an incoming data transfer from a DTI member platform on behalf of a creator.
\*\*Endpoint\*\*
\`\`\`
POST
\`\`\`
\*\*Headers\*\*
\`\`\`
Authorization: Bearer YOUR\_DTI\_SHARED\_SECRET
Content-Type: application/json
\`\`\`
\*\*Request Body\*\*
\`\`\`json
{
"userId": "string",
"dataType": "string",
"payload": {}
}
\`\`\`
\| Field | Type | Description |
\|-------|------|-------------|
\| userId | string | The ForCreaitors creator ID |
\| dataType | string | Type of data being transferred (e.g. instagram\_insights) |
\| payload | object | The data payload from the source platform |
\*\*Response\*\*
\`\`\`json
{
"status": "accepted",
"transferId": "fc\_1712345678\_abc123",
"message": "Transfer received successfully",
"timestamp": "2026-04-07T12:00:00.000Z"
}
\`\`\`
\| Field | Type | Description |
\|-------|------|-------------|
\| status | string | accepted or error |
\| transferId | string | Unique ID to track this transfer |
\| timestamp | string | ISO 8601 timestamp |
\*\*Error Responses\*\*
\| Status | Meaning |
\|--------|---------|
\| 401 | Unauthorized — invalid or missing Bearer token |
\| 405 | Method not allowed — only POST is accepted |
\| 500 | Internal server error |
\---
\### POST /api/dti/auth
Validates that a creator has authorized a data transfer request.
\*\*Endpoint\*\*
\`\`\`
POST
\`\`\`
\*\*Headers\*\*
\`\`\`
Authorization: Bearer YOUR\_DTI\_SHARED\_SECRET
Content-Type: application/json
\`\`\`
\*\*Request Body\*\*
\`\`\`json
{
"userId": "string",
"transferToken": "string"
}
\`\`\`
\| Field | Type | Description |
\|-------|------|-------------|
\| userId | string | The ForCreaitors creator ID |
\| transferToken | string | Token issued when the creator authorized the transfer |
\*\*Response\*\*
\`\`\`json
{
"status": "authorized",
"userId": "string",
"timestamp": "2026-04-07T12:00:00.000Z"
}
\`\`\`
\*\*Error Responses\*\*
\| Status | Meaning |
\|--------|---------|
\| 401 | Unauthorized — invalid or missing Bearer token |
\| 403 | Forbidden — invalid transfer token |
\| 405 | Method not allowed — only POST is accepted |
\| 500 | Internal server error |
\---
\### GET /api/dti/status
Returns the current status of a data transfer by ID.
\*\*Endpoint\*\*
\`\`\`
GET
\`\`\`
\*\*Headers\*\*
\`\`\`
Authorization: Bearer YOUR\_DTI\_SHARED\_SECRET
\`\`\`
\*\*Query Parameters\*\*
\| Parameter | Type | Required | Description |
\|-----------|------|----------|-------------|
\| transferId | string | Yes | The transfer ID returned from POST /api/dti/transfer |
\*\*Response\*\*
\`\`\`json
{
"transferId": "fc\_1712345678\_abc123",
"status": "completed",
"timestamp": "2026-04-07T12:00:00.000Z"
}
\`\`\`
\*\*Transfer Statuses\*\*
\| Status | Meaning |
\|--------|---------|
\| accepted | Transfer received, processing queued |
\| processing | Transfer is being stored |
\| completed | Transfer successfully stored |
\| failed | Transfer encountered an error |
\*\*Error Responses\*\*
\| Status | Meaning |
\|--------|---------|
\| 400 | Bad request — transferId is required |
\| 401 | Unauthorized — invalid or missing Bearer token |
\| 404 | Transfer not found |
\| 405 | Method not allowed — only GET is accepted |
\| 500 | Internal server error |
\---
\## Data Handling
ForCreators is committed to responsible data handling in accordance with DTI standards.
\- All data is transmitted over HTTPS
\- Creator data is stored securely in MongoDB with access controls
\- Creators can request deletion of their data at any time by contacting
\- Data is never sold or shared with third parties without explicit creator consent
\- Access tokens are encrypted at rest
\---
\## Support
For API support or questions, contact us at:
\- Email:
\- Website:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://forcreaitors.gitbook.io/forcreaitors-api-documentation/forcreaitors-api-documentation.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.