Getting started

Create one Farshore Labs account at /signup using your work email. Verify the address from the link in the welcome email; some actions (creating API keys, activating paid services) are blocked until your address is verified.

Open the catalog and choose a service. On first activation Farshore opens a Stripe Setup Intent so you can store a payment method; subsequent activations reuse the same method automatically. Pricing varies by service, and the current rate is shown on each product in the catalog before you subscribe.

Go to Account › API keys and click Create key. Name the key, scope it to the services you actually need (recommended over “any service”), and optionally set an expiry. The full token — a string starting with fsl_live_ — is shown once. Copy it into a secrets manager immediately; we cannot recover it.

Pass the token as a Bearer credential on the Authorization header. Example, using the Azure availability service:

curl https://api.farshorelabs.com/azure-availability/v1/availability \
  -H "Authorization: Bearer fsl_live_********************************************" \
  -G \
  --data-urlencode "service=Microsoft.Compute/virtualMachines" \
  --data-urlencode "sku=Standard_D4s_v5" \
  --data-urlencode "region=eastus2"

The response is JSON, the rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) tell you how much of your monthly quota is left, and any failures follow the documented error format.

• Read Authentication for the precise rules covering both web sessions and Bearer tokens.
• Read API keys for scoping, rotation, and the per-service quota model.
• Pick the service you activated: Azure availability, US Sanctions screening, or Sovereignty finder.