---
title: "GET /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}"
method: GET
path: "/companies/{companySlug}/recurringInvoices/{recurringInvoiceId}"
tags: ["recurring invoices"]
---

# GET /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}

`GET /companies/{companySlug}/recurringInvoices/{recurringInvoiceId}`

## Request

- Base URL: `https://api.fiken.no/api/v2`
- URL: `https://api.fiken.no/api/v2/companies/{companySlug}/recurringInvoices/{recurringInvoiceId}`
- Auth: OAuth 2
  - Authorization code: `https://fiken.no/oauth/authorize`
  - Token URL: `https://fiken.no/oauth/token`

Returns the recurring invoice with the specified id.

## Response `200`

OK

- RecurringInvoiceResult
  - `recurringInvoiceId` integer: Recurring invoice (collection) ID.
  - `createdDate` string, date
  - `description` string: Optional description of the recurring invoice.
  - `daysUntilDueDate` integer
  - `active` boolean: True if at least one job in the collection is active (not paused).
  - `invoiceDraftUuid` string, uuid: UUID of the invoice draft the recurring invoice was created from.
  - `jobs` RecurringInvoiceJobResult[]: One job per customer. Currently the API creates exactly one job per recurring invoice.
    - `jobId` integer
    - `customerId` integer
    - `frequency` Frequency: How often an invoice is generated, e.g. interval 1 + intervalUnit MONTH means once per month.
      - `interval` integer, required: Number of interval units between each generated invoice. Must be at least 1.
      - `intervalUnit` 'DAY' | 'WEEK' | 'MONTH', required: The unit of time between each generated invoice.
    - `nextDate` string, date: The next date an invoice will be generated.
    - `endDate` string, date: Date after which no more invoices are generated, if set.
    - `active` boolean: False when paused.
    - `bankAccountNumber` string
    - `iban` string
    - `bic` string
    - `recipients` RecurringInvoiceRecipient: A job's delivery configuration — who the invoice is sent to and how. Returned on recurringInvoiceJobResult.recipients and used as the body of PUT .../recipients. On PUT it fully replaces the job's recipients: any channel not set is turned off, the job must end up with at least one recipient, and EHF, eFaktura and SMS cannot be combined.
      - `emails` string[]: Ad-hoc email addresses that do not belong to a contact person. On GET, recipients whose email matches one of the customer's contact persons are reported under contactPersonIds instead. On PUT these replace the job's email recipients (together with contactPersonIds).
      - `contactPersonIds` integer[]: Contact persons of the job's customer who receive the invoice. On GET, recipients whose email matches one of the customer's contact persons are reported here. On PUT, each contact person's email is added as a recipient (together with emails); all must belong to the customer and have an email.
      - `ehf` boolean: Send as EHF. Requires the customer to have an organization number and a supported currency.
      - `efaktura` boolean: Send as eFaktura. Requires an approved eFaktura agreement for the company.
      - `letter` boolean: Send as letter to the customer's registered address.
      - `smsPhoneNumber` string, nullable: Phone number to notify by SMS. Omit or null to not send by SMS.
    - `currency` string
    - `net` integer: Net amount (in invoice currency) in cents.
    - `gross` integer: Gross amount (in invoice currency) in cents.
    - `generatedInvoiceIds` integer[]: invoiceId of each invoice generated by this job so far.
    - `lines` InvoiceLineResult[]
      - `net` integer: Net amount of invoice line in cents in original currency.
      - `vat` integer: VAT amount of invoice line in cents in original currency.
      - `vatType` string: Taken from either 1) the line or 2) the product. At least vatType or vatPercent has to be specified. If both are specified, Fiken will assert that the given vat type matches the given vat percent for the issue date. One of: {"HIGH", "MEDIUM", "LOW", "EXEMPT", "EXEMPT_IMPORT_EXPORT", "EXEMPT_REVERSE", "OUTSIDE", "NONE"}. "HIGH" is the most common.
      - `gross` integer: Gross amount of invoice line in cents.
      - `netInNok` integer: Net amount of invoice line in cents in NOK if currency and amounts provided are in foreign currency. This is calculated by Fiken.
      - `vatInNok` integer: VAT amount of invoice line in cents in NOK if currency and amounts provided are in foreign currency. This is calculated by Fiken.
      - `grossInNok` integer: Gross amount of invoice line in cents in NOK if currency and amounts provided are in foreign currency. This is calculated by Fiken.
      - `vatInPercent` number: Percentage value of VAT charged on invoice line. Should be a value between 0 and 1
      - `unitPrice` integer: Net price per unit in invoice currency (in cents).
      - `quantity` number: Number of units to be invoiced.
      - `discount` number: If field is set, all amounts must be given before the discount is applied. The API will calculate the new totals. Discount value should be a value between 0 and 1.
      - `productId` integer: Product Id of product associated with invoice line.
      - `productName` string: Name of product to be printed on invoice line.
      - `description` string: Description of the invoiced product or service.
      - `comment` string: Additional information to be printed on invoice.
      - `incomeAccount` string: Field is similar to vatType, it defaults to the product's income account. Either the line or the product needs to have an income account set.

## Changes

- **2026-09-03** `2473dacdb89c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiken/apis/fiken-api/changes/companies/:companySlug/recurringInvoices/:recurringInvoiceId/get.md)

---

[API](https://skmtc.dev/fiken/apis/fiken-api.md) - [All operations](https://skmtc.dev/fiken/apis/fiken-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiken/apis/fiken-api/revisions/29111da67f94?raw)