Run Blackgoat API workflows from Claude Code
Give Claude Code your exact API contract, not a vague summary. This guide packages the auth model, the highest-signal docs links, and the endpoint examples it needs to calculate tax, verify identities, and submit filings.
Give the agent your API key through environment variables or a secret manager.
Point it at the endpoint docs so it knows the exact request and response shape.
Use direct endpoint examples when you want deterministic tool behavior instead of broad web search.
Install or bootstrap
Use a short setup command or drop the prompt below into your agent session to give it the right operating context.
# Add your Blackgoat API key to Claude Code's environment export BLACKGOAT_API_KEY="YOUR_API_KEY" # Start Claude Code, then attach the prompt from this page claude
Copy prompt
This prompt anchors the agent on your API surface, authentication model, and the right docs entry points.
You are integrating with the Blackgoat API. Use these rules: - Authenticate every request with the X-API-Key header. - Prefer these docs first: - /docs/api/authentication - /docs/api/tax-calculation - /docs/api/tin-verification - /docs/api/filing - Use direct API calls instead of guessing request shapes. - For PIT flows, calculate tax first and reuse calculationId for filing. - When verifying identity, call the TIN or NIN verification endpoints before filing or onboarding. - Return the exact request body and the parsed response fields needed by the user. Base URL: https://pioe.app Core endpoints: - POST /api/v1/tax/calculate - POST /api/v1/tax/calculate-cit - GET /api/v1/verify/tin - GET /api/v1/verify/nin - POST /api/v1/tax/file-pit - POST /api/v1/tax/file-cit - GET /api/v1/tax/filing-status
Endpoint examples
These are the core calls most agent workflows need first: calculate tax, verify identity, and submit a filing.
curl -X POST "https://pioe.app/api/v1/tax/calculate" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taxYear": 2026,
"state": "Lagos",
"incomeStreams": [
{
"type": "salary",
"amount": 850000,
"frequency": "monthly"
}
],
"pensionContribution": 60000
}'Recommended docs to attach
Keep the agent grounded with narrow, high-signal references instead of dumping the entire docs set.