# FAQ

> Short answers to common questions about the Platinux API.

## Getting started

### How do I get an API key?

Sign in at [platinux.net/dashboard/score](https://platinux.net/dashboard/score) and create a key. It is shown only once, so copy it straight away. See [Authentication](/authentication).

### What do I need before I can score?

A template. Call [`GET api-templates`](/templates) and use the `template_id` with `"is_live": true`. Every scoring call needs it.

### What is a template?

The set of buying signals that count towards a score. You create and edit templates in the Platinux app. The API only lists them.

## Scores

### What does the score mean?

A number from 0 to 100. Higher means the company is showing stronger buying signals for what your template looks for.

### Is the score about the person or the company?

The company. When you send an email or a person's LinkedIn profile, we find their current company and score that.

### How long does a score take?

Usually 1 to 3 minutes. Scoring runs in the background: you get a `job_id` (or a `batch_id` for a list) and check back after `check_after_seconds`.

### Why is my result `partial`?

Some data didn't arrive in time. The score uses what did arrive. See [Status values](/status-values).

## Credits

### What does a score cost?

10 credits for a domain, LinkedIn URL, or company or work email. 20 for a generic email (Gmail, Outlook, etc.). Full table in [Credits](/credits).

### Am I charged when nothing is scored?

No. Invalid inputs, temporary emails, companies we can't find and rejected websites all cost 0.

### Is a score reused if I send the same company again?

No. Every run is scored and charged again. Within one list, inputs that lead to the same company are charged once.

### What happens when I run out of credits?

Scoring calls return `402 insufficient_credits`. Top up in the app and try again.

## Limits and errors

### How many companies can I score at once?

Up to 1,000 inputs per bulk call, with one scoring list running at a time per account. See [Limits](/limits).

### Can I score with a template that isn't live?

Not yet. Scoring uses your live template only.

### Which errors are safe to retry?

`500`, `502` and network errors. See [Errors](/errors) for every code.
