Documents

Document storage and management

List documents

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Query Parameters

cursor?string

Pagination cursor

limit?integer

Number of items per page (1-100)

Default20

Range1 <= value <= 100

category?string

folder_id?string

include_deleted?boolean|null

Response Body

`application/json`

curl -X GET "https://api.expensicat.com/api/v1/documents"

{
  "data": [
    {
      "id": "string",
      "organization_id": "string",
      "storage_object_id": "string",
      "category": "receipt",
      "folder_id": "string",
      "deleted_at": "string",
      "deleted_by": "string",
      "created_at": "string",
      "updated_at": "string",
      "file_name": "string",
      "file_path": "string",
      "content_type": "string",
      "size": 0,
      "source": "string",
      "primary_attachment": {
        "attachable_type": "string",
        "attachable_id": "string",
        "entry_name": "string",
        "invoice_number": "string"
      }
    }
  ],
  "meta": {
    "count": 0,
    "next_cursor": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Create document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

source_key?string

File key in the assistant bucket (copies file to vault). Mutually exclusive with file_path.

file_path?string

File path already in vault. Mutually exclusive with source_key.

category*string

attachable_type?string

Entity type to link document to

attachable_id?string

Entity ID to link document to (requires attachable_type)

Response Body

`application/json`

curl -X POST "https://api.expensicat.com/api/v1/documents" \  -H "Content-Type: application/json" \  -d '{    "category": "receipt"  }'

{
  "data": {
    "id": "string",
    "organization_id": "string",
    "storage_object_id": "string",
    "category": "receipt",
    "folder_id": "string",
    "deleted_at": "string",
    "deleted_by": "string",
    "created_at": "string",
    "updated_at": "string",
    "file_name": "string",
    "file_path": "string",
    "content_type": "string",
    "size": 0,
    "source": "string",
    "primary_attachment": {
      "attachable_type": "string",
      "attachable_id": "string",
      "entry_name": "string",
      "invoice_number": "string"
    },
    "attachments": [
      {
        "id": "string",
        "attachable_type": "string",
        "attachable_id": "string",
        "is_primary": true,
        "label": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Get document counts

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Response Body

`application/json`

curl -X GET "https://api.expensicat.com/api/v1/documents/counts"

{
  "data": {
    "all": 0,
    "receipt": 0,
    "invoice": 0,
    "contract": 0,
    "tax": 0,
    "insurance": 0,
    "legal": 0,
    "report": 0,
    "bank_statement": 0,
    "other": 0,
    "trash": 0
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Get document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X GET "https://api.expensicat.com/api/v1/documents/string"

{
  "data": {
    "id": "string",
    "organization_id": "string",
    "storage_object_id": "string",
    "category": "receipt",
    "folder_id": "string",
    "deleted_at": "string",
    "deleted_by": "string",
    "created_at": "string",
    "updated_at": "string",
    "file_name": "string",
    "file_path": "string",
    "content_type": "string",
    "size": 0,
    "source": "string",
    "primary_attachment": {
      "attachable_type": "string",
      "attachable_id": "string",
      "entry_name": "string",
      "invoice_number": "string"
    },
    "attachments": [
      {
        "id": "string",
        "attachable_type": "string",
        "attachable_id": "string",
        "is_primary": true,
        "label": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Update document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

category?string

Response Body

`application/json`

curl -X PATCH "https://api.expensicat.com/api/v1/documents/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "data": {
    "id": "string",
    "organization_id": "string",
    "storage_object_id": "string",
    "category": "receipt",
    "folder_id": "string",
    "deleted_at": "string",
    "deleted_by": "string",
    "created_at": "string",
    "updated_at": "string",
    "file_name": "string",
    "file_path": "string",
    "content_type": "string",
    "size": 0,
    "source": "string",
    "primary_attachment": {
      "attachable_type": "string",
      "attachable_id": "string",
      "entry_name": "string",
      "invoice_number": "string"
    },
    "attachments": [
      {
        "id": "string",
        "attachable_type": "string",
        "attachable_id": "string",
        "is_primary": true,
        "label": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Delete document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X DELETE "https://api.expensicat.com/api/v1/documents/string"

Empty

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Restore document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X POST "https://api.expensicat.com/api/v1/documents/string/restore"

{
  "data": {
    "id": "string",
    "organization_id": "string",
    "storage_object_id": "string",
    "category": "receipt",
    "folder_id": "string",
    "deleted_at": "string",
    "deleted_by": "string",
    "created_at": "string",
    "updated_at": "string",
    "file_name": "string",
    "file_path": "string",
    "content_type": "string",
    "size": 0,
    "source": "string",
    "primary_attachment": {
      "attachable_type": "string",
      "attachable_id": "string",
      "entry_name": "string",
      "invoice_number": "string"
    },
    "attachments": [
      {
        "id": "string",
        "attachable_type": "string",
        "attachable_id": "string",
        "is_primary": true,
        "label": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Permanently delete document

Authorization

AuthorizationBearer <token>

Session JWT or OAuth2 access token

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X DELETE "https://api.expensicat.com/api/v1/documents/string/permanent"

Empty

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

200application/json

403application/json

201application/json

400application/json

403application/json

422application/json

200application/json

403application/json

200application/json

403application/json

404application/json

200application/json

403application/json

404application/json

204

403application/json

404application/json

200application/json

403application/json

404application/json

204

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`