Home/Documentation/Getting started/Your first verified API call

Beginner 5 min

Your first verified API call

Sign up, register an app, get sandbox keys, and send a real CAMARA request end to end in five minutes.

Before you start

You need:

  • A Konera developer portal account (free — created in Step 1 if you don't have it)
  • A terminal with curl (or any HTTP client)
  • About five minutes

Step 1 — Sign up

Register and verify your email. Once verified, you'll land on the developer home. If you're reading this logged in, skip to Step 2.

Step 2 — Create an application

An application manages your access and credentials. From an API page, click Use this API, then: name your app, add a short description, choose the auth strategy, and confirm. Your app is now registered to that API.

Step 3 — Get sandbox credentials

In your application, generate credentials — a client ID and client secret.

Save the secret immediately — it's shown only once. Lose it, and you'll need to generate a new one.

Step 4 — Get an access token

Exchange your credentials for a short-lived token:

curl -X POST https://auth.konera.com/oauth2/token \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "scope=number-verification.read"

Returns an access_token valid for one hour.

Step 5 — Make your first call

Use the token to call the API with a sandbox number:

curl -X POST https://api.pxg.konera.com/camara/number-verification/v2/verify \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phoneNumber":"+14155550123"}'

Successful response:

{ "devicePhoneNumberVerified": true }

Next steps