Uploads

API for uploading billing files for savings estimates

Upload a billing file for a savings estimate

post

Accepts a multipart PDF, CSV, JSON, or text billing file, stores it in Archera's invoice upload bucket, and returns an upload ID. Use this upload ID with the savings-estimate operation. The upload status workflow is: PENDING before storage begins, PROCESSING while the file is being transferred, COMPLETE once it is available for analysis, and ERROR if storage fails.

Path parameters

org_idstring · uuidRequired

Body

multipart/form-data

descriptionstring · max: 255 · nullableOptional

Optional partner-supplied context for the uploaded billing file

filestring · binaryWrite-onlyRequired

Billing PDF, CSV, JSON, or text file to upload for a savings estimate

Responses

201

Created

application/json

idstring · uuidRead-onlyRequired

created_atstring · date-timeRead-onlyRequired

org_idstring · max: 50Read-onlyRequired

file_namestring · max: 255Read-onlyRequired

content_typestring · max: 255Read-onlyRequired

size_bytesintegerRead-onlyRequired

descriptionstring · max: 255 · nullableRead-onlyRequired

upload_statusstring · enumRead-onlyRequiredPossible values:

sourceundefined · enumRead-onlyRequiredPossible values:

detected_typestring · max: 64 · nullableRead-onlyRequired

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

422

Unprocessable Content

application/json

500

Internal server error

application/json

default

Default error response

application/json

post/v1/org/{org_id}/uploads

HTTPcURLJavaScriptPython

POST /v1/org/{org_id}/uploads HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 36

{
  "description": null,
  "file": "binary"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-08-08T11:53:17.719Z",
  "org_id": "text",
  "file_name": "text",
  "content_type": "text",
  "size_bytes": 1,
  "description": null,
  "upload_status": "PENDING",
  "source": "agent_upload",
  "detected_type": null,
  "available_actions": []
}

Get uploaded billing file status

get

Returns metadata and upload status for a partner API upload. Clients can poll this endpoint until upload_status is COMPLETE, then pass the upload ID to the savings-estimate operation.

Path parameters

org_idstring · uuidRequired

upload_idstring · uuidRequired

Responses

200

OK

application/json

idstring · uuidRead-onlyRequired

created_atstring · date-timeRead-onlyRequired

org_idstring · max: 50Read-onlyRequired

file_namestring · max: 255Read-onlyRequired

content_typestring · max: 255Read-onlyRequired

size_bytesintegerRead-onlyRequired

descriptionstring · max: 255 · nullableRead-onlyRequired

upload_statusstring · enumRead-onlyRequiredPossible values:

sourceundefined · enumRead-onlyRequiredPossible values:

detected_typestring · max: 64 · nullableRead-onlyRequired

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

500

Internal server error

application/json

default

Default error response

application/json

get/v1/org/{org_id}/uploads/{upload_id}

HTTPcURLJavaScriptPython

GET /v1/org/{org_id}/uploads/{upload_id} HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-08-08T11:53:17.719Z",
  "org_id": "text",
  "file_name": "text",
  "content_type": "text",
  "size_bytes": 1,
  "description": null,
  "upload_status": "PENDING",
  "source": "agent_upload",
  "detected_type": null,
  "available_actions": []
}