How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIs.io Provider Control API

Claim, correct and improve your own listing. Most operations require the Influence plan; reporting that our data is wrong is free and always will be.

APIs.io Provider Control API is one of 21 APIs that APIs.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Provider Control. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 13 paths, and defines 5 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://apis.io/api/v1.

13 operations 13 paths 5 schemas 3 GET10 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Server
https://apis.io/api/v1
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

APIs.io Provider Control API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth).

Paths & Operations 13

Across 13 paths, the API surfaces 13 operations — 3 GET, 10 POST. Each is listed below with its method, path, parameters, and response codes.

Provider Control 13

Claim, correct and improve your own listing. Most operations require the Influence plan; reporting that our data is wrong is free and always will be.

POST
/providers/{slug}/correction
Report that the catalog has this provider wrong
reportCorrection 1 param body → 202400404503
POST
/providers/{slug}/claim
Create or return your claim on this listing
claimListing 1 param body → 202200402409422503
POST
/providers/{slug}/facts
Create or update your pending fact correction for this listing
correctFacts 1 param body → 200202400402503
POST
/providers/{slug}/submit
Create or update an artifact pointer for this listing
submitArtifact 1 param body → 200202400402503
POST
/providers/{slug}/visibility
Request restricted listing or removal
setVisibility 1 param body → 202400402503
POST
/providers/{slug}/dispute
Dispute something the rating says about this provider
disputeFinding 1 param body → 202400402503
POST
/providers/{slug}/generate
What APIs.io can generate on this provider's behalf
generateArtifacts 1 param → 200402
POST
/providers/{slug}/projection
What a set of fixes would move the score to
simulateFixes 1 param body → 200400402
GET
/providers/{slug}/remediation
The ranked, costed punch list for this provider
whatCanIFix 1 param → 200402
GET
/providers/{slug}/gates
Band gates for this provider, and what is unmet
readinessGates 1 param → 200402
GET
/providers/{slug}/rating/checks
Per-check Kin Score results for this provider
providerRatingChecks 1 param → 200402404503
POST
/checks
Ask for a provider, industry, tag or area to be re-profiled
requestCheck body → 200402503
POST
/gaps/report
Tell us what you looked for and did not find
reportGap body → 202400503

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are BandGate (12 properties), ReadinessGates (8 properties), QueuedRequest (8 properties), Error (2 properties). Each schema is shown below with its type and property counts.

Error
object
2 properties
UpsertResult
object
A write whose repeat behaviour is defined. outcome names which branch ran, so a caller retrying after a timeout can tell what the server did without re-reading…
QueuedRequest
object
Every write here is a REQUEST, not a completed action. completed is always false on acceptance.
8 properties
ReadinessGates
object
What stands between this listing and the next agent-readiness band. Agent Readiness is additive, so a provider can reach a band's score floor and still be held…
8 properties 4 required
BandGate
object
One band's score floor and the gate guarding it.
12 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apis-io-provider-control-api-openapi.yml Raw ↑

Other APIs APIs.io publishes across the network.

APIs.io Submit API
APIs.io Areas API
APIs.io Artifact Types API
APIs.io Industries API
APIs.io Insights API
APIs.io Providers API
APIs.io Ratings API
APIs.io Regions API
APIs.io Search API
APIs.io Synthesis API
APIs.io Tags API
APIs.io Cohorts API
Where this information came from

This is an independent, third-party profile of APIs.io Provider Control API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.