​
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-UserCredits used specifically for /user endpoint
X-Credits-Used-SearchCredits used specifically for /jobs/search endpoint
X-Credits-Used-AssessCredits used specifically for /jobs/assess endpoint
X-Credits-RemainingRemaining general credits (-1 for unlimited accounts)
X-Credits-Remaining-SearchRemaining search-specific credits (if configured)
X-Credits-Remaining-AssessRemaining assess-specific credits (if configured)
X-Calls-UserTotal number of calls made to /user endpoint
X-Calls-SearchTotal number of calls made to /jobs/search endpoint
X-Calls-AssessTotal number of calls made to /jobs/assess endpoint

​
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