--- title: "GET /companies/{companySlug}/purchases" method: GET path: "/companies/{companySlug}/purchases" tags: ["purchases"] --- # GET /companies/{companySlug}/purchases `GET /companies/{companySlug}/purchases` ## Request - Base URL: `https://api.fiken.no/api/v2` - URL: `https://api.fiken.no/api/v2/companies/{companySlug}/purchases` - Auth: OAuth 2 - Authorization code: `https://fiken.no/oauth/authorize` - Token URL: `https://fiken.no/oauth/token` Returns all purchases for given company ## Query parameters - `page` integer - `pageSize` integer - `date` string, date - `dateLe` string, date - `dateLt` string, date - `dateGe` string, date - `dateGt` string, date - `lastModified` string, date - `lastModifiedLe` string, date - `lastModifiedLt` string, date - `lastModifiedGe` string, date - `lastModifiedGt` string, date - `sortBy` 'date asc' | 'date desc' - `paid` boolean - `settledDate` string, date - `settledDateLe` string, date - `settledDateLt` string, date - `settledDateGe` string, date - `settledDateGt` string, date - `contactId` integer ## Response `200` OK - PurchaseResult[] - `purchaseId` integer: Id of given purchase. - `transactionId` integer - `identifier` string: Invoice/sale number or similar. - `date` string, date, required: Payment date, format yyyy-mm-dd - `dueDate` string, date: Due date of the invoice, format yyyy-mm-dd - `kind` 'cash_purchase' | 'supplier', required: Purchased with cash or through a supplier. - `paid` boolean, required - `lines` OrderLine[], required - `lineId` integer: Stable identifier of this purchase/sale line, returned in GET responses. Use this value as `lineId` when setting up accrual for the line. Ignored if sent in a create/update request. - `description` string, required: Description of the product or service. - `netPrice` integer: Net amount of order line in cents. Either netPrice or netPriceInCurrency must be provided. - `vat` integer: VAT amount of order line in cents. - `account` string: Expense account (kostnadskonto) associated with payment. - `vatType` string, required: Vat Types for SALES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, EXEMPT_IMPORT_EXPORT, EXEMPT, OUTSIDE, EXEMPT_REVERSE] Vat Types for PURCHASES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, HIGH_DIRECT, HIGH_BASIS, MEDIUM_DIRECT, MEDIUM_BASIS, NONE_IMPORT_BASIS, HIGH_FOREIGN_SERVICE_DEDUCTIBLE, HIGH_FOREIGN_SERVICE_NONDEDUCTIBLE, LOW_FOREIGN_SERVICE_DEDUCTIBLE, LOW_FOREIGN_SERVICE_NONDEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_DEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_NONDEDUCTIBLE] - `netPriceInCurrency` integer: Net amount in currency (in cents) - `vatInCurrency` integer: VAT amount in currency (in cents) - `projectId` integer: If a purchase is split over several projects, project/line can be specified. This field is only to be used for purchases. - `supplier` Contact - `contactId` integer - `createdDate` string, date: Date that contact was created in Fiken, format yyyy-mm-dd. - `lastModifiedDate` string, date: Date that contact was last modified in Fiken, format yyyy-mm-dd. - `name` string, required - `email` string - `organizationNumber` string: Brreg organization number. - `customerNumber` integer - `customerAccountCode` string: Format 1500:XXXXX - `phoneNumber` string - `memberNumber` number: A number that can be used to connect a contact to your own data. This field is no longer used and instead memberNumberString should be used. - `memberNumberString` string: A number/id that can be used to connect a contact to your own data. - `supplierNumber` integer - `supplierAccountCode` string: Format 2400:XXXXX - `customer` boolean: True if the contact is a customer. It is possible for a contact to be both customer and supplier. - `supplier` boolean: True if the contact is a supplier. It is possible for a contact to be both supplier and customer. - `bankAccountNumber` string - `contactPerson` ContactPerson[] - `contactPersonId` integer - `name` string, required - `email` string, required - `phoneNumber` string - `address` Address - `streetAddress` string - `streetAddressLine2` string - `city` string - `postCode` string - `country` string, required - `notes` ContactNote[] - `author` string - `note` string - `currency` string: ISO 4217 currency code. Default foreign currency to use when creating invoice to this contact (USD, EUR, SEK etc) - `language` string, nullable: The language to use when sending documents to this contact. NORWEGIAN or ENGLISH. Defaults to NORWEGIAN. - `inactive` boolean: Whether the contact has been deactivated (true) or is active (false) - `daysUntilInvoicingDueDate` integer: Default number of days until due date for invoices. - `discount` number: Discount value should be a percent with a value between 0 and 100. Decimal values such as 25.5 are also allowed. - `address` Address - `streetAddress` string - `streetAddressLine2` string - `city` string - `postCode` string - `country` string, required - `groups` string[] - `documents` Attachment[] - `uuid` string, uuid: Unique id of the attachment (the underlying file's UUID). Use this value as the attachmentUuid path parameter when deleting the attachment. - `filename` string: The name of the underlying file. - `identifier` string: User-defined identifier for attachment. Could be the Invoice Id or receipt number for example. - `downloadUrl` string: For use with API credentials (bearer token or oauth 2) - `downloadUrlWithFikenNormalUserCredentials` string: Requires the user to login with username and password in Fiken. - `comment` string: Field for additional information for this attachment. - `type` 'invoice' | 'reminder' | 'unspecified' | 'ocr' | 'bank_statement' - `currency` string, required: ISO 4217 currency code - `paymentAccount` string - `paymentDate` string, date: Payment date, format yyyy-mm-dd - `payments` Payment[] - `paymentId` integer: Id of given payment. - `date` string, date, required: Payment date, format yyyy-mm-dd - `account` string, required: Account associated with payment. - `amount` integer, required: Amount paid in the specified currency. If no currency is provided then currency defaults to "NOK". Formatted in cents (34000 = 340.00) - `amountInNok` integer: Attribute of a foreign payment only. Is required if amount is provided in currency other than NOK and should be the actual amount that was received in the bank account. Fiken calculates the value based on the exchange rate for the given date if no amountInNok is sent. Formatted in cents (500000 = 5000.00) - `currency` string: Only specify the currency if other than "NOK", otherwise default currency is "NOK". ISO 4217 currency code - `fee` integer: Any fees additional to the amount paid in the specified currency. This is always a "NOK" amount even if the sale currency is a different currency. - `purchaseAttachments` Attachment[] - `uuid` string, uuid: Unique id of the attachment (the underlying file's UUID). Use this value as the attachmentUuid path parameter when deleting the attachment. - `filename` string: The name of the underlying file. - `identifier` string: User-defined identifier for attachment. Could be the Invoice Id or receipt number for example. - `downloadUrl` string: For use with API credentials (bearer token or oauth 2) - `downloadUrlWithFikenNormalUserCredentials` string: Requires the user to login with username and password in Fiken. - `comment` string: Field for additional information for this attachment. - `type` 'invoice' | 'reminder' | 'unspecified' | 'ocr' | 'bank_statement' - `kid` string: Norwegian KID number. Number from 2 to 25 digits long. - `project` ProjectResult[] - `projectId` integer - `number` string - `name` string - `description` string - `startDate` string, date: Start date for the project, inclusive, format yyyy-mm-dd - `endDate` string, date: End date for the project, inclusive, format yyyy-mm-dd - `contact` Contact - `contactId` integer - `createdDate` string, date: Date that contact was created in Fiken, format yyyy-mm-dd. - `lastModifiedDate` string, date: Date that contact was last modified in Fiken, format yyyy-mm-dd. - `name` string, required - `email` string - `organizationNumber` string: Brreg organization number. - `customerNumber` integer - `customerAccountCode` string: Format 1500:XXXXX - `phoneNumber` string - `memberNumber` number: A number that can be used to connect a contact to your own data. This field is no longer used and instead memberNumberString should be used. - `memberNumberString` string: A number/id that can be used to connect a contact to your own data. - `supplierNumber` integer - `supplierAccountCode` string: Format 2400:XXXXX - `customer` boolean: True if the contact is a customer. It is possible for a contact to be both customer and supplier. - `supplier` boolean: True if the contact is a supplier. It is possible for a contact to be both supplier and customer. - `bankAccountNumber` string - `contactPerson` ContactPerson[] - `contactPersonId` integer - `name` string, required - `email` string, required - `phoneNumber` string - `address` Address - `streetAddress` string - `streetAddressLine2` string - `city` string - `postCode` string - `country` string, required - `notes` ContactNote[] - `author` string - `note` string - `currency` string: ISO 4217 currency code. Default foreign currency to use when creating invoice to this contact (USD, EUR, SEK etc) - `language` string, nullable: The language to use when sending documents to this contact. NORWEGIAN or ENGLISH. Defaults to NORWEGIAN. - `inactive` boolean: Whether the contact has been deactivated (true) or is active (false) - `daysUntilInvoicingDueDate` integer: Default number of days until due date for invoices. - `discount` number: Discount value should be a percent with a value between 0 and 100. Decimal values such as 25.5 are also allowed. - `address` Address - `streetAddress` string - `streetAddressLine2` string - `city` string - `postCode` string - `country` string, required - `groups` string[] - `documents` Attachment[] - `uuid` string, uuid: Unique id of the attachment (the underlying file's UUID). Use this value as the attachmentUuid path parameter when deleting the attachment. - `filename` string: The name of the underlying file. - `identifier` string: User-defined identifier for attachment. Could be the Invoice Id or receipt number for example. - `downloadUrl` string: For use with API credentials (bearer token or oauth 2) - `downloadUrlWithFikenNormalUserCredentials` string: Requires the user to login with username and password in Fiken. - `comment` string: Field for additional information for this attachment. - `type` 'invoice' | 'reminder' | 'unspecified' | 'ocr' | 'bank_statement' - `completed` boolean: Whether the project is completed or not. - `deleted` boolean: Whether the purchase has been deleted or not - `settled` boolean: If the purchase as been marked as settled (True) or not (False). - `settledDate` string, date: Date the the purchase was marked as settled, format yyyy-mm-dd ## Changes - **2026-09-03** `2473dacdb89c`: 14 info - added the new optional `query` request parameter `contactId` - added the new optional `query` request parameter `lastModified` - added the new optional `query` request parameter `lastModifiedGe` - added the new optional `query` request parameter `lastModifiedGt` - …10 more - **2026-03-28** `dff97b55851e`: 20 info - added the new optional `query` request parameter `date` - added the new optional `query` request parameter `dateGe` - added the new optional `query` request parameter `dateGt` - added the new optional `query` request parameter `dateLe` - …16 more - **2023-05-26** `e093a0c9db87`: 2 info - added the new optional `query` request parameter `paid` - the response optional property `items/lines/items/projectId` became write-only for the status `200` - **2021-12-08** `4813e5666340`: 12 breaking, 3 warning, 18 info - the response property `items/project/items/contact/address/city` became optional for the status `200` - the response property `items/project/items/contact/address/postCode` became optional for the status `200` - the response property `items/project/items/contact/address/streetAddress` became optional for the status `200` - the response property `items/project/items/contact/contactPerson/items/address/city` became optional for the status `200` - …29 more [Operation history](https://skmtc.dev/fiken/apis/fiken-api/changes/companies/:companySlug/purchases/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)