Help Center

How can we help?

Guides for getting the most out of Hiremium — your dashboard workflow, AI usage, billing, the developer API, and troubleshooting. Pick a topic on the right, or read straight through.

Jump to a topic

Overview

Hiremium is an automated recruitment tool: post a job, upload your applicants’ CVs in bulk, and let the AI read, analyze and score each one against the job. You come back to a ranked shortlist — strongest matches first — with a report for every candidate.

New here? The fastest path: create an account, post a job, and upload some CVs from your dashboard. Prefer to integrate it into your own product? There is also a developer API.

Create an account

Sign up with your email (or a social login) from the registration page. You will need to verify your email before you can start — this keeps accounts secure.

Your dashboard

Your dashboard is where everything happens: your jobs, your uploads, your ranked candidates, and your remaining AI usage. From here you post jobs, upload CVs, review shortlists, and manage your plan and team.

Post a job

Create a job from your dashboard and describe the role, the responsibilities, and the skills that matter. Every candidate is scored against this job, so the clearer the description, the sharper the matching. You can mark certain skills as required so the report shows who has them and who is missing them.

Upload CVs in bulk

Open the Upload page, choose the job, and add your applicants. You can add resumes together, or drop a single ZIP containing the whole batch — a large batch is split up and processed for you. Common formats work — PDF, Word and plain text — including scanned or image-based CVs, which are read automatically.

Already have candidate details in a spreadsheet? Use the CSV import tab, map your columns to the candidate fields, and import the rows straight in.

How analysis works

Each CV is read and turned into a clean, structured profile — contact details, experience, education, projects, skills and languages — then analyzed and scored against your job, one by one. You can watch progress on the batch page; results appear as each candidate finishes, and the list keeps re-ordering so the best matches stay on top.

Candidates & scores

Every candidate gets a match score that reflects how well they fit the job. Your candidate list ranks automatically — top scorers first — so you review the strongest matches before anything else, instead of scrolling through raw uploads.

The candidate report

Open any candidate to see their full report: the match score, the reasons to hire, the concerns to weigh, and which required skills they have and are missing — plus their key details. Everything you need to make a call sits on one screen.

Shortlists & compare

Shortlist the candidates you like to set them aside, and compare your top picks side by side to weigh them against each other before moving to interviews.

Reports & export

Each job has a screening report summarising your candidates and results. When you are ready to share with your team, export your matched candidates and shortlists — the export includes their key details and scores.

Team & seats

Invite colleagues into your workspace so they can review candidates alongside you, up to the number of seats your plan includes. Manage members and invites from the Team page.

Settings

Manage your profile, your workspace, and your notification preferences from Settings. Your plan, AI usage and billing history live under Billing.

How AI usage works

Your plan includes a monthly amount of AI usage, measured in Requests. Analyzing one CV against a job uses one AI Request; uploading files and browsing your ranked shortlists do not. AI usage resets when your subscription renews and does not roll over. If a request fails on our side, it is refunded automatically — you only spend AI usage on results you actually get.

Plans & billing cycles

Plans are AI-usage allowances billed monthly or yearly and renew automatically. Yearly plans include a discounted annual allowance granted up front. Compare options on the pricing page. Payments are securely handled by our third-party payment provider.

Upgrading your plan

On the pricing page, choose a higher plan (or switch your current plan to yearly). Upgrading starts a new checkout; once it completes, your previous subscription is superseded so you are never billed twice, and your new AI usage becomes available. You cannot switch to the same or a lower plan while a subscription is active.

Cancelling

Cancel any time from the receipt or customer-portal link in your payment confirmation email. Your access and remaining AI usage continue until the end of the current paid period; the subscription simply does not renew after that.

Refund policy

We do not offer refunds for subscription fees or unused AI usage, except where required by law. Cancelling stops future renewals but does not refund the current period. The one automatic exception is fairness-based: if a request fails on our side, that AI usage is refunded to your balance — you are never charged for a failed result. See our Refund Policy and Terms of Service for details.

API overview

Beyond the dashboard, Hiremium offers a developer API to build match scoring and resume parsing into your own job board or ATS. You call it over HTTPS with a single API key, and it draws from the same AI usage as your dashboard. Full request and response details live in the API docs.

Generate an API key

From your dashboard, mint an API key. It is shown once — copy it immediately and store it like a password. You can regenerate it (which revokes the old one) or revoke it entirely at any time.

  • Keep the key server-side; never put it in browser or mobile code.
  • Anyone with your key can use your AI usage.

Authentication

Send your key as a Bearer token on every request — Authorization: Bearer YOUR_API_KEY — along with Accept: application/json. A missing or invalid key returns 401 unauthenticated. See the API docs for full examples.

Endpoints

Two endpoints cover the workflow: /api/v1/matching-score returns a match score with a written reason for a job and an application, and /api/v1/parse-resume turns a CV file into a structured profile. Full fields, formats and examples are in the API docs.

Async jobs

For large volumes, use the /async endpoints. They return a job_id immediately; poll /api/v1/jobs/{id} until the status is completed (or failed). Polling does not use AI usage.

Common errors

API errors return a JSON body with an error.code and message. The most common:

  • 401 unauthenticated — key missing, invalid, or revoked.
  • 402 no_active_subscription / insufficient_ai_usage — no active plan, or not enough AI usage left for the request.
  • 422 validation_failed — the request body is missing or invalid (details in errors).
  • 415 unsupported_file_type — the uploaded file type is not supported.
  • 429 rate_limited — too many requests; slow down or use the async endpoints.
  • 502 ai_provider_error — the AI step failed; the request is refunded automatically.

Failed requests & refunds

If a request is charged but the AI step fails on our side, we automatically refund that AI usage and mark it as refunded in your usage log. You only pay for results you actually receive.

Data & security

Traffic is encrypted over HTTPS, API keys are stored hashed, and uploaded files are stored privately and served only through your account. We do not use your submitted content to train models. See the Privacy Policy for the full picture.

Still need help?

Can’t find what you need? Our team is happy to help with your workflow, billing, integration, or anything else. Contact us and we’ll reply within one business day.