​
GET /jobs/list

List all active jobs for your API key. This endpoint returns all job descriptions you’ve created that are currently active, along with their creation dates and unique IDs.

​
🔑 Credits

  • Cost: FREE - No credits charged for listing jobs

​
Authentication

API key can be provided in two ways:
  • Header: x-api-key: YOUR_API_KEY
  • Query parameter: api_key=YOUR_API_KEY

​
Query Parameters

NameTypeRequiredDescription
api_keystring✅ YesAPI key for authentication (can also be in x-api-key header)

​
Response Headers

HeaderDescription
X-Credits-UsedTotal credits used by your API key across all endpoints
X-Credits-Used-AssessCredits used specifically for assessment operations
X-Credits-RemainingRemaining credits (-1 for unlimited accounts)

​
Response

Returns an array of job objects with metadata. 
{
  "jobs": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "description": "Senior Python Developer\n\nWe are looking for an experienced Python developer...",
      "created": "2025-08-06T10:30:45",
      "active": true
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "description": "Data Engineer\n\nJoin our analytics team to build scalable data solutions...",
      "created": "2025-08-05T14:22:10",
      "active": true
    }
  ]
}

​
Examples

Using cURL 
curl -X GET "https://api.b2d.ai/jobs/list" \
  -H "x-api-key: YOUR_API_KEY"
Using Python 
import requests

headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get("https://api.b2d.ai/jobs/list", headers=headers)

if response.status_code == 200:
    data = response.json()
    jobs = data['jobs']
    
    print(f"Found {len(jobs)} active jobs:")
    for job in jobs:
        print(f"- Job ID: {job['id']}")
        print(f"  Created: {job['created']}")
        print(f"  Description: {job['description'][:100]}...")
        print()
    
    # Check usage headers
    print(f"Credits used: {response.headers.get('X-Credits-Used')}")
    print(f"Credits remaining: {response.headers.get('X-Credits-Remaining')}")
else:
    print(f"Error: {response.status_code} - {response.json()}")
Raw HTTP Request 
GET https://api.b2d.ai/jobs/list?api_key=YOUR_API_KEY

​
Response Fields

FieldTypeDescription
idstringUnique job identifier for use with other endpoints
descriptionstringOriginal job description text
createdstringISO 8601 timestamp when job was created
activebooleanWhether the job is currently active (always true in results)

​
Error Responses

Status CodeDescription
401Unauthorized - Missing API key
403Forbidden - Invalid API key
500Internal Server Error
Example Error Response: 
{
  "error": "Invalid API key"
}

​
Next Steps

Use the job IDs from this response with:

​
Usage Notes

  • Only shows jobs created with your API key
  • Jobs are returned in reverse chronological order (newest first)
  • All returned jobs have active: true (inactive jobs are filtered out)
  • The full job description is included in each result
  • Creation timestamps are in ISO 8601 format with timezone information