Server API allows you to get information about visitors (using the /visitors
endpoint) or about individual events (using the /events
endpoint) in a server environment.
Server API is only for server-side usage, it's not intended to be used from the client side, whether it's a browser or a mobile device.
If you want to identify browsers in your web application, read our JS Agent guide.
If you want to identify mobile devices using native mobile SDKs, see Android or iOS.
Server API requests do not count toward your monthly plan and are not billed.
Regions
The server API is available in the Global, EU and Asia (Mumbai) regions:
Region | Base URL | Server Location |
---|---|---|
Global | https://api.fpjs.io | Global |
EU | https://eu.api.fpjs.io | Frankfurt, Germany |
Asia (Mumbai) | https://ap.api.fpjs.io | Mumbai, India |
Use the Base URL dropdown in the right column of each endpoint to select the correct base URL according to your application's region.
Authentication
There are 2 ways to authenticate with the API: with auth header or with a query parameter. All unauthenticated requests will return HTTP 403 Forbidden
response.
Auth header
This is the recommended way of API authentication. When making an API request, add Auth-API-Key
HTTP header with your secret API key.
API key query parameter
This method of authentication is easy to use when you want to test it in the browser. However, we don't recommend using it in production.
Example request with an API key query parameter:
// Paste this URL into your browser
// replace the API key with your real secret API key
https://api.fpjs.io/visitors/someVisitorId?api_key=<<apiKey>>
Server API SDKs
For a smoother developer experience, we offer typed SDKs for these languages:
Pick one of them as the Language on the endpoint page's top right corner to see an example request using that SDK.
The SDKs (and this reference) are based on a Server API OpenAPI schema, which is also available on Github:
Trying it out
You can try calling the Server API directly from this reference:
- You are going to need your Secret API Key. You can find it in your Fingerprint Dashboard > App Settings > API Keys.
- To make a request you will need either a
visitorId
orrequestId
of an identification event associated with your application. Go to Dashboard > Fingerprint to see your identification events. - Scroll down to one of the endpoints, for example Get visits by visitorId.
- Set Authentication to your secret API key.
- Set the visitor_id path parameter to some
visitorId
from your dashboard (orrequestId
in the case of Get event by requestId). - Make sure the Base URL corresponds to your application's region.
- Click Try it!
A real API response will appear in the Response section. Alternatively, you can view the prepared response examples there.