Authentication

{
  "service_type": "platform",
  "base_url": "https://api.personio.de",
  "auth_method": "oauth2",
  "auth_config": {
    "token_url": "https://api.personio.de/v1/auth",
    "grant_types": ["client_credentials"],
    "scopes": [],
    "notes": "Personio uses a custom authentication endpoint that accepts client_id and client_secret in the JSON body and returns a bearer token. This is not standard OAuth2 client_credentials in form-encoded format, but functionally equivalent."
  },
  "endpoints": [
    {
      "path": "/v1/auth",
      "method": "POST",
      "description": "Obtain an access token using client credentials",
      "parameters": [
        {
          "name": "client_id",
          "in": "body",
          "required": true,
          "type": "string"
        },
        {
          "name": "client_secret",
          "in": "body",
          "required": true,
          "type": "string"
        }
      ],
      "response": {
        "success": true,
        "data": {
          "token": "string"
        }
      }
    }
  ],
  "pricing_model": {
    "type": "subscription",
    "details": {
      "notes": "Personio is a commercial HR management platform. API access is included with the subscription. No separate pricing for the authentication API."
    }
  },
  "rate_limits": {},
  "capabilities": [
    "Authentication",
    "Employee data management",
    "HR workflows",
    "Absence management",
    "Payroll integration",
    "Recruiting",
    "Reporting"
  ],
  "raw_analysis": "The given URL 'https://personio.de:authentication' appears to be malformed or incomplete. Personio is a comprehensive HR management platform for small and medium-sized businesses. Its API is served under 'https://api.personio.de'. The authentication endpoint is 'POST /v1/auth' which takes client_id and client_secret as JSON body parameters and returns a bearer token. This token is then used for subsequent API calls. The service is mature, well-documented, and widely used. Integrations include payroll providers, accounting software, and other HR tools. API access requires an active Personio subscription. No public pricing for API alone; it's part of the overall platform subscription. The platform is not a standalone authentication service but rather an HR platform with its own authentication mechanism. The provided URL likely indicates that the user is looking for Personio's authentication API details. Therefore, the base_url should be corrected to the API endpoint, and the authentication method is essentially OAuth2-like client credentials. Rate limits are not publicly documented but are likely enforced per API key."
}

1/3 tests passed

{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 7.0,
    "first_try_success": 5.0,
    "response_parseability": 7.5,
    "error_clarity": 7.0,
    "doc_quality": 6.5,
    "auth_simplicity": 6.0,
    "latency": 9.5,
    "consistency": 7.5
  },
  "pricing_normalized": {
    "type": "subscription",
    "notes": "Commercial HR platform; API access bundled with subscription, no separate auth pricing disclosed. Not publicly available as a free tier — gated behind sales/subscription."
  },
  "issues": [
    "No pricing published — likely sales-gated, making it hard for users to self-onboard",
    "Returns 404 for /robots.txt and /llms.txt — no agent-oriented discovery files",
    "Auth requires Client ID/Secret from a Personio account (likely human admin setup), blocking agent self-onboarding",
    "Commercial subscription model requires procurement, not instant signup"
  ],
  "recommendations": [
    "Publish llms.txt and robots.txt to support agent discovery",
    "Offer a documented sandbox/free tier so agents can test without a sales cycle",
    "Expose transparent API-level pricing or integrate 'Sign in with Notlogin' for agent-friendly onboarding",
    "Surface structured OpenAPI/JSON schema specs prominently for parseability"
  ]
}