Pricing

Credits per call

Credits are issued to a tenant in batches. Each call is charged once at the API’s price; repeat queries and errors are free.

meta200 OK
"meta": {
  "op": "company.search",
  "credits": 0,
  "deduplicated": true,
  "requestId": "9d2459aa3d9b7b18"
}

01

API prices

Each API has its own price, agreed with your plan; price changes apply to new calls. Once your account is open, see the Workspace “APIs” page or the credits field of GET /api/v1/ops. meta.credits in each response shows what that call cost.

GET /api/v1/ops → creditsmeta.credits

02

When credits are charged

01

A normal result

At the API’s price

Charged
02

Repeat query: same tenant, same params, the same data already returned

meta.deduplicated is true

Free
03

Forced refetch (force=1)

At the API’s price

Charged
04

No record (company not found, verification not_found, no branch)

The lookup completed; repeats stay free

Charged
05

Identity verification

Checked live every time, no repeat queries

Charged
06

Invalid params, API not enabled, daily limit reached

Rejected before the lookup

Free
07

Data source error or timeout

The hold is refunded at once

Free

03

Credit batches

Issuing
Issued to the tenant in batches, each with an amount, an expiry (365 days by default) and a source: purchase, grant, trial or adjustment
Expiry
Each batch expires on its date. No monthly reset, no rollover
Order
Charged from the earliest-expiring batch that covers the price; one call never spans two batches
Balance
The sum of all unexpired batches, in the Workspace or via GET /api/v1/quota
Out of credits
402 quota_exceeded with need and available; resend the same request after a top-up

04

Bills

Bills are grouped by calendar month (Beijing time), one row per app × API, with calls, free repeat queries, errors and credits charged. Export to CSV and open it in Excel.

FAQ

How do I get credits?

FIM issues credits to your tenant in batches; self-service purchase is not available yet. Each batch has an amount and an expiry, from a purchase, grant or trial. Contact us via “Get access”.

Do credits reset monthly?

No. Each batch expires on its own date with no monthly reset and no rollover. Calls are charged from the earliest-expiring batch that covers the price.

Should I cache results to save credits?

No. Within a tenant, repeating a query with the same params and getting the same data is free. Keep a local copy only if you need lower latency or data during a source outage.

Is “no record” charged?

Yes. Company not found, verification not_found and an empty branch lookup are all completed answers. Repeats remain free.

Can several systems share credits?

Yes. Credits belong to the tenant and all of its apps share the balance; usage and bills are broken down per app.

Is there an SDK?

No. The APIs are plain HTTP and JSON, so your existing HTTP client works. Generate a typed client from the OpenAPI spec if you need one.

Get an account and your first key

FIM opens accounts. Tell us about your company and use case, and we will set up a tenant and issue credits.