Currents News API Documentation

Authentication

Token check endpoint: Use /v1/auth to check whether an API key is valid. There is no /v2/auth endpoint.

Authentication is handled with a simple API key that you can get from your dashboard.

Authentication Methods

Use the Authorization header for new integrations. The query-string form is retained for legacy compatibility but should not be used in shared examples, browser URLs, logs, or production code.

Authorization Header

Header Name: `Authorization`

Send as Authorization: YOUR_KEY or Authorization: Bearer YOUR_KEY.

Legacy Query Parameter

`apiKey`

Supported for existing clients only. Prefer the Authorization header because URLs are commonly logged and shared.

Examples

cURL

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.currentsapi.services/v1/latest-news"

JavaScript (fetch)

// Authorization Header
fetch('https://api.currentsapi.services/v1/latest-news', {
  headers: {
    'Authorization': 'Bearer YOUR_KEY'
  }
})
  .then(response => response.json())
  .then(data => console.log(data));

Python (requests)

import requests

# Authorization Header
response = requests.get(
  'https://api.currentsapi.services/v1/latest-news',
  headers={'Authorization': 'Bearer YOUR_KEY'}
)

data = response.json()
print(data)

Error Handling

401 Unauthorized

If API key is missing, the API returns:

{
  "status": "401",
  "msg": "Authentication required"
}

Invalid tokens return the same status code with message "Invalid token".

Tip: Make sure you're using the correct API key from your dashboard. You can regenerate it if needed.

Next Steps

Now that you know how to authenticate, explore:

Latest News Endpoint Search Endpoint Rate Limits

Need help? Contact support or check our pricing plans.