Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/altruistiq-data-source-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Altruistiq Datasource API
x-logo:
url: ./aq.svg
altText: Altruistiq Logo
version: 1.0.0
description: '# Definitions
An **Activity** is a business process that has taken place, which is relevant for emissions measurement.'
servers:
- url: https://app.altruistiq.com/
description: Altruistiq Server
tags:
- name: Data Source
description: '### Altruistiq’s datasource API enables you to:
- Create new datasources
- Manage existing datasources (read, update)
- Upload data to a datasource
A datasource is the place where you will share a single data format with altruistiq and where you will categorise it so that we can calculate emissions in an automated way.'
paths:
/api/public/v1/datasource/{dataSourceId}/upload:
get:
security:
- bearerAuth: []
tags:
- Data Source
summary: Start A Multipart Upload
operationId: startMultipartUpload
description: Use this endpoint to start your multipart upload and retrieve an uploadId and fileId.
x-codeSamples:
- lang: javascript
label: JS
source: "const headers = {\n 'Authorization': 'Bearer tokenId123',\n 'Content-Type': 'application/json'\n}\n\nconst response = await fetch(`https://app.altruistiq.com/api/public/v1/datasource/123/upload?fileName=testing.csv&userEmail=user@altruistiq.com`, {\n method: 'GET',\n headers: headers,\n})\n\nconst multipartStartResponse = await response.json()\n\nconst results = {\n uploadId: multipartStartResponse.uploadId,\n fileId: multipartStartResponse.fileId\n}\n"
- lang: python
label: Python
source: "file_name = \"testing.csv\"\nuser_email = \"user@altruistiq.com\"\nauth_headers = {'Authorization': 'Bearer ' + token}\nstart_response = requests.get(\n f\"https://app.altruistiq.com/api/public/v1/datasource/{datasource_id}/upload?fileName={file_name}&userEmail={user_email}\",\n headers=auth_headers\n)\nstart_response_json = start_response.json()\nupload_id = start_response_json[\"uploadId\"]\nfile_id = start_response_json[\"fileId\"]\n"
parameters:
- name: userEmail
in: query
description: Email of user initiating upload.
required: true
schema:
type: string
- name: fileName
in: query
description: Name of file that is being uploaded.
required: true
schema:
type: string
- name: dataSourceId
in: path
description: ID of datasource
required: true
schema:
type: string
responses:
'201':
description: Multipart upload started
content:
application/json:
schema:
properties:
status:
type: string
example: Multipart Upload started
uploadId:
type: string
example: '123'
fileId:
type: string
example: '123'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/404'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/500'
post:
security:
- bearerAuth: []
tags:
- Data Source
summary: Upload A File To A Datasource
operationId: uploadFile
description: Use this endpoint to upload your binary.
x-codeSamples:
- lang: python
label: Python
source: "part = 1\nparts = []\nauth_headers = {'Authorization': 'Bearer ' + token}\nfor chunk in chunk_file(file_name):\n files = [\n ('file', (file_name, chunk, 'application/octet-stream')),\n ('uploadId', (None, upload_id)),\n ('partNo', (None, part))\n ]\n upload_response = requests.post(datasource_url, headers=auth_headers, files=files)\n upload_response_json = upload_response.json()\n parts.append(upload_response_json[\"parts\"])\n part += 1\n"
- lang: javascript
label: JS
source: "// First part\nlet formData = new FormData()\n\nformData.append(\n 'file',\n new Blob([fileChunk], {type: 'application/octet-stream'}),\n 'fileName.csv'\n)\nformData.append('partNo', 1)\nformData.append('uploadId', 123)\n\nconst headers = {\n 'Content-Type': 'multipart/form-data;',\n 'Content-Range': 'bytes 0-100/1000',\n 'Authorization': 'Bearer tokenId123',\n}\n\nconst res1 = axios({\n method: 'POST',\n data: formData,\n url: `https://app.altruistiq.com/api/public/v1/datasource/123/upload`,\n headers\n});\n\nparts.push(res.data)\n\n// Second part\nformData = new FormData()\n\nformData.append('partNo', 2)\nformData.append('uploadId', 123)\n\nconst headers = {\n 'Content-Type': 'multipart/form-data;',\n 'Content-Range': 'bytes 101-200/1000',\n 'Authorization': 'Bearer tokenId123',\n}\n\nconst res2 = axios({\n method: 'POST',\n data: formData,\n url: `https://app.altruistiq.com/api/public/v1/datasource/123/upload`,\n headers\n});\n\nparts.push(res.data)\n\n//etc...\n"
parameters:
- name: Content-Type
in: header
type: string
example: multipart/form-data
- name: Content-Range
in: header
type: string
example: bytes 0-100/1000
- name: dataSourceId
in: path
description: ID of datasource
required: true
schema:
type: string
requestBody:
content:
multipart/form-data:
schema:
required:
- file
- uploadId
- partNo
type: object
properties:
file:
type: array
items:
type: string
format: binary
uploadId:
type: string
example: '123'
partNo:
type: number
example: 1
responses:
'201':
description: File Uploaded
content:
application/json:
schema:
properties:
dataSourceId:
type: string
example: '123'
parts:
type: array
example:
- PartNumber: 1
ETag: '123'
- PartNumber: 2
ETag: '123'
status:
type: string
example: Upload Complete
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/404'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/500'
/api/public/v1/datasource/{dataSourceId}/upload/{uploadId}/file/{fileId}/complete:
post:
security:
- bearerAuth: []
tags:
- Data Source
summary: Complete A Multipart File Upload
operationId: completeFileUpload
description: Use this endpoint to complete a file upload.
x-codeSamples:
- lang: javascript
label: JS
source: "const headers = {\n 'Authorization': `Bearer tokenId123`,\n 'Content-Type': 'application/json'\n}\n\n await fetch('https://app.altruistiq.com/api/public/v1/datasource/123/upload/uploadId123/file/fileId123/complete', {\n method: 'POST',\n headers: headers,\n body: JSON.stringify({\n [\n {\n \"PartNumber\": 1,\n \"ETag\": \"123\"\n },\n {\n \"PartNumber\": 2,\n \"ETag\": \"123\"\n }\n ],\n 'test.csv'\n })\n })\n"
- lang: python
label: Python
source: "end_req_headers = {\n 'Authorization': 'Bearer ' + token,\n 'Content-Type': 'application/json'\n}\nend_req_data = {'fileName': file_name, 'parts': parts}\nend_response = requests.post(\n f\"https://app.altruistiq.com/api/public/v1/datasource/{datasource_id}/upload/{upload_id}/file/{file_id}/complete\",\n data=json.dumps(end_req_data),\n headers=end_req_headers\n)\n"
parameters:
- name: dataSourceId
in: path
description: ID of datasource
required: true
schema:
type: string
- name: uploadId
in: path
description: ID of upload
required: true
schema:
type: string
- name: fileId
in: path
description: ID of file
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
fileName:
type: string
example: test.csv
parts:
format: array
example:
- PartNumber: 1
ETag: '123'
- PartNumber: 2
ETag: '123'
responses:
'200':
description: File Multipart Upload Complete
content:
application/json:
schema:
properties:
status:
type: string
example: Multipart Upload Complete
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/404'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/500'
components:
schemas:
'500':
type: object
properties:
status:
type: string
example: Server Error
description: Internal Error
'404':
type: object
properties:
status:
type: string
example: Not found
description: Resource not found
'401':
type: object
properties:
status:
type: string
example: Unauthorized
description: Request was unauthorized
securitySchemes:
bearerAuth:
type: apiKey
name: Authorization
in: header
description: 'Enter the token with the `Bearer: ` prefix, e.g. `Bearer: apiKey`.'
oauth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://app.altruistiq.com/api/public/v1/oauth2/token