GuidesFirst API Request

Your First API Request

Send your first authenticated request to Ctxfy.

Overview

This guide walks you through sending a single authenticated request to the Ctxfy API.

Prerequisites

  • Base URL (e.g. https://api.ctxfy.com)
  • API Key from the Ctxfy dashboard

Step 1: Get an API key

Create an API key in the Ctxfy dashboard. Copy the key and store it securely — it is shown only once.

Step 2: Call an endpoint

Example — list your spaces:

curl https://api.ctxfy.com/v1/spaces \
  -H "Authorization: Bearer YOUR_API_KEY"

Step 3: Interpret the response

  • 200 — Success; response body contains data.
  • 401 — Invalid or missing API key. Check Authentication.
  • 429 — Rate limit exceeded. See Troubleshooting.

Next steps

Quickstart

Create a space, upload a source, and check processing status.