FIfiken
contacts

GET /companies/{companySlug}/contacts/{contactId}

Changed on

Retrieves specified contact. ContactId is returned with a GET contacts call as the first returned field. ContactId is returned in the Location response header for POST contact.

Request

  • Base URL
    https://api.fiken.no/api/v2
  • URL
    https://api.fiken.no/api/v2/companies/{companySlug}/contacts/{contactId}
  • Auth
    OAuth 2
    Authorization code: https://fiken.no/oauth/authorize
    Token URL: https://fiken.no/oauth/token

Response

OK

contactIdinteger
createdDatestring date

Date that contact was created in Fiken, format yyyy-mm-dd.

lastModifiedDatestring date

Date that contact was last modified in Fiken, format yyyy-mm-dd.

namestring required
emailstring
organizationNumberstring

Brreg organization number.

customerNumberinteger
customerAccountCodestring

Format 1500:XXXXX

phoneNumberstring
memberNumbernumber

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.

memberNumberStringstring

A number/id that can be used to connect a contact to your own data.

supplierNumberinteger
supplierAccountCodestring

Format 2400:XXXXX

customerboolean

True if the contact is a customer. It is possible for a contact to be both customer and supplier.

supplierboolean

True if the contact is a supplier. It is possible for a contact to be both supplier and customer.

bankAccountNumberstring
currencystring

ISO 4217 currency code. Default foreign currency to use when creating invoice to this contact (USD, EUR, SEK etc)

languagestring nullable

The language to use when sending documents to this contact. NORWEGIAN or ENGLISH. Defaults to NORWEGIAN.

inactiveboolean

Whether the contact has been deactivated (true) or is active (false)

daysUntilInvoicingDueDateinteger

Default number of days until due date for invoices.

discountnumber

Discount value should be a percent with a value between 0 and 100. Decimal values such as 25.5 are also allowed.

groupsstring[]

Example response

{
  "contactId": 2747365,
  "createdDate": "2018-04-03",
  "lastModifiedDate": "2018-04-03",
  "name": "Fiken AS",
  "email": "kontakt@fiken.gmail",
  "organizationNumber": "913312465",
  "customerNumber": 51248,
  "customerAccountCode": "1500:20001",
  "phoneNumber": "62158537",
  "memberNumber": 5464,
  "memberNumberString": "5464",
  "supplierAccountCode": "2400:20001",
  "bankAccountNumber": "11112233334",
  "contactPerson": [
    {
      "contactPersonId": 2747365,
      "name": "Betty Boop",
      "email": "bb@gmail.com",
      "phoneNumber": "98573564",
      "address": {
        "streetAddress": "Karl Johan 34",
        "streetAddressLine2": "H0405",
        "city": "Oslo",
        "postCode": "0550",
        "country": "Norway"
      }
    }
  ],
  "notes": [
    {
      "author": "Betty Boop",
      "note": "Garage 45"
    }
  ],
  "currency": "NOK",
  "language": "Norwegian",
  "inactive": true,
  "daysUntilInvoicingDueDate": 15,
  "discount": 25,
  "address": {
    "streetAddress": "Karl Johan 34",
    "streetAddressLine2": "H0405",
    "city": "Oslo",
    "postCode": "0550",
    "country": "Norway"
  },
  "documents": [
    {
      "uuid": "745b2f15-1234-4408-8bf2-b1d2d7610cb2",
      "filename": "invoice_24760.pdf",
      "identifier": "24760",
      "type": "invoice"
    }
  ]
}

Changes

  • 2473dacdb89cRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • dff97b55851eRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional write-only property memberNumberString to the response with the status

    • info

      response property memberNumber deprecated