DevScout Partner API
This documentation describes how to integrate your platform with DevScout to check, in real time, whether a user is an active subscriber, allowing you to grant exclusive discounts and benefits automatically and securely.
Every DevScout subscriber has a unique verification code (UUID) visible in their dashboard. The verification flow is:
Every request must include your partner API Key in the X-Partner-Key header. The key is provided by the DevScout team after your platform is registered as a partner.
X-Partner-Key: your_api_key_hereNever expose your API Key on the front-end. Always make the call from your server (server-side) to protect the key.
https://api.devscout.app/api/verify/subscribercurl -X GET \
"https://api.devscout.app/api/verify/subscriber?code=550e8400-e29b-41d4-a716-446655440000" \
-H "X-Partner-Key: your_api_key_here"const response = await fetch(
'https://api.devscout.app/api/verify/subscriber?code=' + userCode,
{
headers: {
'X-Partner-Key': process.env.DEVSCOUT_PARTNER_KEY,
},
}
);
const data = await response.json();
if (data.is_subscriber) {
// Grant the discount
console.log('Plan:', data.plan_name);
console.log('Valid until:', data.valid_until);
} else {
console.log('User is not an active subscriber');
}import requests
import os
response = requests.get(
'https://api.devscout.app/api/verify/subscriber',
params={'code': user_code},
headers={'X-Partner-Key': os.getenv('DEVSCOUT_PARTNER_KEY')}
)
data = response.json()
if data.get('is_subscriber'):
print(f"Plan: {data['plan_name']}")
print(f"Valid until: {data['valid_until']}"){
"success": true,
"is_subscriber": true,
"plan_slug": "scout-master",
"plan_name": "Scout Master",
"valid_until": "2025-06-01T00:00:00",
"user_name": "joao_dev"
}{
"success": true,
"is_subscriber": false,
"plan_slug": "scout-free",
"plan_name": "Scout Free",
"valid_until": null,
"user_name": "joao_dev"
}{
"success": false,
"is_subscriber": false,
"error": "Invalid verification code or partner key"
}success·booleantrue if the request was processed successfully
is_subscriber·booleantrue if the user has an active subscription (not free)
plan_slug·stringPlan identifier: scout-free, scout-explorer, scout-master
plan_name·stringHuman-readable plan name
valid_until·string | nullISO date when the subscription expires
user_name·stringDevScout username (for confirmation)
Rate limit
60 requests per minute per API Key. Implement short-lived caching (e.g. 5 minutes) to avoid unnecessary calls.
Never expose the API Key
Always make the call server-side (backend). Never on the front-end or in mobile apps.
Validate the user_name
For extra security, ask the user to confirm their DevScout username and compare it with the returned user_name.
Handle errors gracefully
If our API is unavailable (HTTP 5xx), consider allowing access temporarily and retrying later.
Interested in offering exclusive benefits to DevScout subscribers? Contact our team to get your API Key and be listed in the partners dashboard.
Get in Touch