List Jobs

Retrieve a paginated list of your split jobs.

GET /api/v1/splits

Authentication

API Key required via X-API-Key header.

Request Headers

Header	Required	Description
X-API-Key	Yes	Your API key

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Results per page (max 100)
status	string	--	Filter by status: queued, processing, completed, failed
sortBy	string	createdAt	Sort field: createdAt, completedAt
sortOrder	string	desc	Sort order: asc, desc

Response

200 OK

{
  "data": [
    {
      "id": "job_abc123",
      "status": "completed",
      "splitMode": "duration",
      "segmentDuration": 600,
      "outputFormat": "mp3",
      "segmentCount": 3,
      "createdAt": "2026-03-29T10:00:00Z",
      "completedAt": "2026-03-29T10:01:23Z"
    },
    {
      "id": "job_def456",
      "status": "processing",
      "splitMode": "fileSize",
      "maxFileSize": 26214400,
      "outputFormat": "mp3",
      "segmentCount": null,
      "createdAt": "2026-03-29T10:05:00Z",
      "completedAt": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Code Examples

cURL

curl "https://api.audiospliter.com/api/v1/splits?status=completed&limit=10" \
  -H "X-API-Key: as_live_abc123"

Node.js

const params = new URLSearchParams({ status: 'completed', limit: '10' });
const response = await fetch(
  `https://api.audiospliter.com/api/v1/splits?${params}`,
  { headers: { 'X-API-Key': process.env.AUDIOSPLITER_API_KEY } }
);
const { data, pagination } = await response.json();
console.log(`Found ${pagination.total} jobs`);

Python

import requests, os

response = requests.get(
    'https://api.audiospliter.com/api/v1/splits',
    headers={'X-API-Key': os.environ['AUDIOSPLITER_API_KEY']},
    params={'status': 'completed', 'limit': 10},
)
result = response.json()
print(f"Found {result['pagination']['total']} jobs")

Rate Limiting

This endpoint counts toward your per-minute rate limit. See Rate Limits.