API Reference

The Gigapay API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded requests, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API server

https://api.gigapay.se/v2/ - Production server

https://api.demo.gigapay.se/v2/ - Demo server

The demo version serves as a test environment for developers working to integrate with our API. No money flows through the demo environment.

Browsable API

Both the live and demo environment render a human-friendly HTML output for each resource, when the HTML format is requested by a web browser. This allows for easy browsing and interaction with the available resources. We strongly recommend you test our Browsable API before starting to integrate with our API, as it will give you a far more intuitive understanding of the API compared to reading this documentation.

Authentication

import requests

response = requests.get(
    'https://api.gigapay.se/v2/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/

fetch("https://api.gigapay.se/v2/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The Gigapay API uses API keys to identify and authenticate requests. You can request a key by contacting us at support@gigapay.se. Note that you will receive separate keys for the live and demo environment.

Your API keys carry many privileges, so make sure you keep them secure. Do not share your API keys in publicly accessible areas such as GitHub, client-side code, etc.

Authorization to the API is performed through a token-based HTTP Authentication scheme. To authorize requests, include your key in the Authorization HTTP header. Note that the API key should be prefixed by the string literal Token, with whitespace separating the two strings.

To specify which Integration you are acting as you need to provide the Integration-ID header.

Tokens

Authentication Token:

Token:

Integration ID:

Replacing the above tokens with your own will add them to the provided code examples, making them executable.

Unauthenticated Requests

API requests without valid authentication will fail with the HTTP response code 401. If you are getting unexpected 401 responses, ensure that your URL is correct. API calls made over plain HTTP will be redirected with the response code 301, and API calls with incorrect placed / will be redirected with the response code 307 to the correct URL, and most HTTP clients will automatically follow the redirects while stripping out the authorization headers, resulting in the 401 response. Disable automated redirects or be mindful of this.

IP-whitelisting

The Gigapay API Supports IP-whitelisting. When requesting API-keys, let us know if you want to only allow access from certain IP addresses. If IP-whitelisting is enabled, API requests made from a non-whitelisted IP will be rejected with HTTP response code 403.

Language

import requests

response = requests.get(
    'https://api.gigapay.se/v2/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b',
        'Accept-Language': 'sv',
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -H "Accept-Language: en" https://api.gigapay.se/v2/

fetch("https://api.gigapay.se/v2/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b",
        "Accept-Language": "sv",
    }
})

The default language of the API is English. This document is written assuming you have the language set to English. To change language set the Accept-Language header to your preferred language.

Events

An example Employee object with event timestamps:

{
    "id": "25d2af38-59b9-4f73-9452-51787fed5c84", 
    "name": "Karl Karlsson", 
    "cellphone_number": null, 
    "email": "karl.karlsson@gmail.com", 
    "metadata": {}, 
    "created_at": "2019-05-20T15:33:08.974624Z", 
    "notified_at": "2019-05-20T15:33:12.581720Z", 
    "claimed_at": "2019-05-21T09:13:32.575721Z",
    "verified_at": "2019-05-21T09:13:48.625263Z"
}

The Gigapay API is driven by actions taken by the parties involved in each Payout; the Client making the Payout, Gigapay facilitating it, and the Employee receiving it. The flowchart below illustrates each of these actions and the corresponding events.

Note that the Employee and Payout flow typically occur in parallel as the Employee is usually created when, or close in time to when, their first Payout is created.

All objects are timestamped when an associated event occurs. The field is simply the name of the event suffixed with _at.

Subscribing to Events

An example webhook for the Employee.verified event:

POST https://jobmatchr.se/webhooks/employees/ HTTP/1.1
Content-Type: application/json
Gigapay-Signature: t=1583327301,v1=ad583e2b2093c8d6fb3b65e04b99fc5988e98c0c312909acad334072da7e99ec
...

{
    "id": "25d2af38-59b9-4f73-9452-51787fed5c84", 
    "name": "Karl Karlsson", 
    "cellphone_number": null, 
    "email": "karl.karlsson@gmail.com", 
    "metadata": {
        "user_id": 3
    }, 
    "created_at": "2019-05-20T15:33:08.974624Z", 
    "notified_at": "2019-05-20T15:33:12.581720Z", 
    "claimed_at": "2019-05-21T09:13:32.575721Z"
    "verified_at": "2019-05-21T09:13:48.625263Z"
}

The Gigapay API allows you to register Webhooks in order to receive real-time updates on events related to your Gigapay account. They are optional, but the preferred way of monitoring the status of objects. We can send callbacks on the following events:

Employee.created
Employee.notified
Employee.claimed
Employee.verified
Payout.created
Payout.notified
Payout.accepted
Invoice.created
Invoice.paid

The notifications simply contain the object that triggered the event, as represented in the API.

Gigapay Signature

Example code to verify a Gigapay Signature:

secret_key = '...asId'

# If you're doing this in shell; parse the request manually:
timestamp='...'
signature='...'
body='...'

payload=${timestamp}.${body}

calculated_signature=$(echo -n $payload | openssl dgst -sha256 -hmac $secret_key)

if [ $signature == $calculated_signature ]; then
    ...
fi

import hmac

secret_key = '...asId'

t, v1 = request.headers['Gigapay-Signature'].split(',')
timestamp = t.split('=')[1]
signature = v1.split('=')[1]

payload = timestamp + '.' + request.body

hmac.new(secret_key.encode('utf-8'), digestmod='sha256')
hmac.update(payload.encode('utf-8'))
calculated_signature = hmac.hexdigest()

hmac.compare_digest(signature, calculated_signature)

import hmacSHA512 from 'crypto-js/hmac-sha512';

let secret_key = '...asId'

let [t, v1] = request.get('Gigapay-Signature').split(',')
let timestamp = t.split('=')[1]
let signature = v1.split('=')[1]

let payload = timestamp + '.' + request.body

let calculated_signature = hmacSHA512(payload, secret_key);

calculated_signature === signature

The notification is signed using the secret_key for the Webhooks, the signature is included in the notification as a Gigapay-Signature header. This allows you to verify that the events were sent by Gigapay, and not by a third party.

The signature consists of two parameters;

t, the timestamp of when the notification was sent, and;

v the signature of the current scheme.

The only valid signature scheme is currently v1, which is the HMAC algorithm as described in RFC 2104 using SHA256 as digestmod.

To verify signatures using the v1 scheme, extract the timestamp from the Gigapay-Signature header, and the JSON-encoded notification from the request body. Join these strings with a period, ., as a separator. Compute an HMAC with the SHA256 hash function using the Webhook’s secret key as the key. Lastly ensure that the signature in the header and the calculated signature matches.

Errors

HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD, OPTIONS
...

{"detail":"Method \"DELETE\" not allowed."}

Gigapay uses HTTP response codes to indicate whether an API request was successful. Codes in the 2XX range indicate success; codes in the 4XX range indicate that the request failed, given the information provided; codes in the 5XX range indicate an error with Gigapay's servers. Response codes in the 4XX range generally indicate a client error and will as such include information in the body of the response describing the cause of the error.

HTTP/1.1 400 Bad Request
...

{"description": ["This field may not be blank."]}

Validation errors returned on otherwise valid requests are structured differently. They will respond with the status code 400and include the field names as the keys in the response. If the validation error was not specific to a particular field then the non_field_errors key will be used.

Expanding objects

Request to retrieve a Payout object with the related Employee object expanded:

import requests

response = requests.get(
    'https://api.gigapay.se/v2/payouts/9472/?expand=employee',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' 'https://api.gigapay.se/v2/payouts/9472/?expand=employee'

fetch("https://api.gigapay.se/v2/payouts/9472/?expand=employee", {
    method: "GET",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

Returns a response formatted as such:

{
    "id": "9472",
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "description": "Instagram samarbete 2021-11-13.",
    "employee": {
        "id": "1847",
        "name": "Albin Lindskog",
        "email": "albin@mail.com",
        "cellphone_number": "+46700000001",
        "country": "SWE",
        "metadata": {},
        "created_at": "2019-05-22T10:32:36.118753Z",
        "notified_at": null,
        "claimed_at": null,
        "verified_at": null
    },
    "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
    "invoiced_amount": "1000.00",
    "metadata": {
        "campaign_id": 12394
    },
    "start_at": null,
    "end_at": null,
    "created_at": "2019-05-23T10:32:38.118753Z",
    "notified_at": null,
    "accepted_at": null
}

Many objects contain the identifier of a related object in their response properties. For example, a Payout has an associated Employee identifier. Those objects can be expanded inline with the expand request parameter. Objects that can be expanded are noted in this documentation. You can use the expand param on any endpoint which includes expandable fields, including the create endpoints. You can expand multiple objects at once by repeating the expand request parameter.

Pagination

Request to retrieve two Employee objects per page, and the second page:

import requests

response = requests.get(
    'https://api.gigapay.se/v2/employees/?page_size=2&page=2',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' 'https://api.gigapay.se/v2/employees/?page_size=2&page=2'

fetch("https://api.gigapay.se/v2/employees/?page_size=2&page=2", {
    method: "GET",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

Returns a response formatted as such:

{
    "count": 17,
    "next": "https://api.gigapay.se/v2/employees/?page=3",
    "previous": "https://api.gigapay.se/v2/employees/?page=1",
    "results": [
        {
            "id": "1f1d1263-0e79-4787-b573-6df81b44bfc2",
            "name": "Albin Lindskog",
            "cellphone_number": "+46703000000",
            "email": null,
            "metadata": {
                "user_id": 2
            },
            "created_at": "2019-05-20T15:33:08.974624Z", 
            "notified_at": "2019-05-20T15:33:12.581720Z", 
            "claimed_at": "2019-05-21T09:13:32.575721Z",
            "verified_at": "2019-05-21T09:13:48.625263Z"
        }, {
            "id": "25d2af38-59b9-4f73-9452-51787fed5c84",
            "name": "Karl Karlsson",
            "cellphone_number": null,
            "email": "karl.karlsson@gmail.com",
            "metadata": {
                "user_id": 3
            },
            "created_at": "2019-05-20T15:33:08.974624Z", 
            "notified_at": "2019-05-20T15:33:12.581720Z", 
            "claimed_at": null,
            "verified_at": null
        }
    ]
}

The Gigapay API uses pagination on all of its list-endpoints. These endpoints all share a common structure, optionally accepting page and a page_size request parameter. page specifies which page to return and page_size the number of objects per page. The objects returned are contained within the result field of the response.

Filtering

Request to retrieve all non-accepted Payouts belonging to a specific Employee:

import requests

response = requests.get(
    'https://api.gigapay.se/v2/payouts/?employee=12&accepted_at_null=True',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' 'https://api.gigapay.se/v2/payouts/?employee=12&accepted_at_null=True'

fetch("https://api.gigapay.se/v2/payouts/?employee=12&accepted_at_null=True", {
    method: "GET",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

Returns a response formatted as such:

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "0177270d-f94b-4ab9-88ba-ac1fa2f791aa",
            "amount": "100.00",
            "cost": "137.99",
            "currency": "SEK",
            "description": "Lön genom Gigapay",
            "employee": "12",
            "invoice": "bab4b830-47d6-4a24-a460-3289897f6e8e",
            "metadata": {},
            "start_at": null,
            "end_at": null,
            "created_at": "2019-05-22T10:32:38.118753Z",
            "notified_at": "2019-05-22T10:38:19.874623Z",
            "accepted_at": null
        }
    ]
}

Request to retrieve all employees with string "skoog" in name, email or phone number:

import requests

response = requests.get(
    'https://api.gigapay.se/v2/employees/?search=skoog',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' 'https://api.gigapay.se/v2/employees/?search=skoog'

fetch("https://api.gigapay.se/v2/employees/?search=skoog", {
    method: "GET",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

Returns a response formatted as such:

{
    "count": 2, 
    "next": null,
    "previous": null, 
    "results": [
        {
            "id": "59cc997d-b4bc-4b2d-ac2d-0101ea9ba241", 
            "name": "Joakim Karlsson", 
            "cellphone_number": "+46703100002", 
            "email": "skoog@gigapay.co", 
            "country": "SWE", 
            "metadata": {}, 
            "created_at": "2022-04-11T13:05:27.565954Z", 
            "notified_at": "2022-04-11T13:05:27.565954Z", 
            "claimed_at": "2022-04-11T13:05:27.565954Z", 
            "verified_at": "2022-04-11T14:05:27.565954Z"
        }, {
            "id": "481c3138-5710-4086-9237-a082e87d624f", 
            "name": "Joakim Skoog", 
            "cellphone_number": "+46703100001", 
            "email": "joakims@gigapay.co", 
            "country": "SWE", 
            "metadata": {}, 
            "created_at": "2022-04-11T13:05:27.543935Z", 
            "notified_at": "2022-04-11T13:05:27.543935Z", 
            "claimed_at": "2022-04-11T13:05:27.543935Z", 
            "verified_at": "2022-04-11T14:05:27.543935Z"
        }
    ]
}

Request to retrieve all payouts to employees with string "skoog" in name, email or phone number or with string "skoog" in the description of the payout:

import requests

response = requests.get(
    'https://api.gigapay.se/v2/payouts/?search=skoog',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' 'https://api.gigapay.se/v2/payouts/?search=skoog'

fetch("https://api.gigapay.se/v2/payouts/?search=skoog", {
    method: "GET",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
}

Returns a response formatted as such:

{
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "bfdac591-4bc5-45d3-9e93-27a885c8b130",
            "cost": "1396.32",
            "invoiced_amount": "1368.95",
            "amount": "1000.00",
            "currency": "SEK",
            "description": "Test",
            "metadata": {},
            "start_at": null,
            "end_at": null,
            "created_at": "2022-04-14T08:31:11.773275Z",
            "notified_at": null,
            "accepted_at": null,
            "employee": {
                "id": "411246da-0b59-41c6-8b87-1e5abb73af30",
                "name": "Kalle Karlsson",
                "cellphone_number": "+46703100003",
                "email": "skoog@gigapay.co",
                "country": "SWE",
                "metadata": {},
                "created_at": "2022-04-14T08:31:11.741713Z",
                "notified_at": "2022-04-14T08:31:11.741713Z",
                "claimed_at": "2022-04-14T08:31:11.741713Z",
                "verified_at": "2022-04-14T09:31:11.741713Z"
            },
            "invoice": "f4377884-e4c0-4e65-bbd1-24f52973b933",
            "full_salary_specification": false
        },
        {
            "id": "1bc53e19-3589-4f92-aece-360006cfe196",
            "cost": "1396.32",
            "invoiced_amount": "1368.95",
            "amount": "1000.00",
            "currency": "SEK",
            "description": "Test",
            "metadata": {},
            "start_at": null,
            "end_at": null,
            "created_at": "2022-04-14T08:31:11.763167Z",
            "notified_at": null,
            "accepted_at": null,
            "employee": {
                "id": "411246da-0b59-41c6-8b87-1e5abb73af30",
                "name": "Kalle Karlsson",
                "cellphone_number": "+46703100003",
                "email": "skoog@gigapay.co",
                "country": "SWE",
                "metadata": {},
                "created_at": "2022-04-14T08:31:11.741713Z",
                "notified_at": "2022-04-14T08:31:11.741713Z",
                "claimed_at": "2022-04-14T08:31:11.741713Z",
                "verified_at": "2022-04-14T09:31:11.741713Z"
            },
            "invoice": "b749b0fd-a82a-4644-a7c8-e89ae891cc23",
            "full_salary_specification": false
        },
        {
            "id": "bf216a95-0560-46c8-b9c7-0d15850aea23",
            "cost": "1396.32",
            "invoiced_amount": "1368.95",
            "amount": "1000.00",
            "currency": "SEK",
            "description": "Test",
            "metadata": {},
            "start_at": null,
            "end_at": null,
            "created_at": "2022-04-14T08:31:11.755175Z",
            "notified_at": null,
            "accepted_at": null,
            "employee": {
                "id": "1fa40cc7-a2c9-43ab-972f-eb322bded992",
                "name": "Joakim Skoog",
                "cellphone_number": "+46703100002",
                "email": "joakim@gigapay.co",
                "country": "SWE",
                "metadata": {},
                "created_at": "2022-04-14T08:31:11.707438Z",
                "notified_at": "2022-04-14T08:31:11.707438Z",
                "claimed_at": "2022-04-14T08:31:11.707438Z",
                "verified_at": "2022-04-14T09:31:11.707438Z"
            },
            "invoice": "e5647953-4df7-4166-9066-f9dea11b66f3",
            "full_salary_specification": false
        }
    ]
}

The Gigapay API supports filtering on all of its list-endpoints. These filters are of two types, either relational filters or timestamp filters. Which filters are available are described under each endpoint.

Relational filters filter out all objects belonging to a specified object. They are use the format {field_name}={object_id}.

Timestamp filters are used to filter out objects having had a certain event associated with them. They can be used to filter on whether an event has occurred with the null suffix, e.g. {field_name}_null={Bool}, or when, by using the _before and _after suffix, e.g. {field_name}_before={ISO 8601 string}.

Idempotency

Registering an Employee with an idempotency key

import requests

response = requests.post(
    'https://api.gigapay.se/v2/employees/',
    json={
        'name': 'Albin Lindskog',
        'cellphone_number': '+4670000000',
        'country': 'SWE',
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Idempotency-Key': 'afjkakkknbkasaskkaksdakjdnsakja',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Idempotency-Key': 'afjkakkknbkasaskkaksdakjdnsakja' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"name": "Albin Lindskog", "cellphone_number": "+4670000001", "country": "SWE"}' https://api.gigapay.se/v2/employees/

fetch("https://api.gigapay.se/v2/employees/", {
    method: "POST",
    body: JSON.stringify({
        name: "Albin Lindskog",
        cellphone_number: "+4670000000",
        country: "SWE",
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Idempotency-Key": "afjkakkknbkasaskkaksdakjdnsakja",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The Gigapay API supports idempotency to safely retry requests without accidentally performing the same operation twice. Gigapay offers two mechanism of idempotency; idempotency keys and object ids.

To perform an idempotent request using an idempotency-key, provide the additional Idempotency-Key header to the request. Idempotency keys works by storing the responses of previous requests. Subsequent requests with the same key return the same response, without performing the action specified in the request. Keys expire after 24 hours, so a new response is generated if a key is reused outside that timeframe.

Registering an Employee with a specific id

import requests

response = requests.post(
    'https://api.gigapay.se/v2/employees/',
    json={
        'id': 19472,
        'name': 'Albin Lindskog',
        'cellphone_number': '+4670000000',
        'country': 'SWE',
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Idempotency-Key': 'afjkakkknbkasaskkaksdakjdnsakja' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 19472, "name": "Albin Lindskog", "cellphone_number": "+4670000001", "country": "SWE"}' https://api.gigapay.se/v2/employees/

fetch("https://api.gigapay.se/v2/employees/", {
    method: "POST",
    body: JSON.stringify({
        id: 19472,
        name: "Albin Lindskog",
        cellphone_number: "+4670000000",
        country: "SWE",
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

To perform an idempotent request using an object id simply specify the id when creating the object. Object ids ensure idempotency when creating object as no objects can have the same id. Subsequent requests with the same id will return an error. The uniqueness of an id is guaranteed for the lifetime of the object.

Metadata

Registering an Employee with metadata:

import requests

response = requests.post(
    'https://api.gigapay.se/v2/employees/',
    json={
        'name': 'Albin Lindskog',
        'cellphone_number': '+4670000000',
        'country': 'SWE',
        'metadata': {
            'user_id': 1847,
        },
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"name": "Albin Lindskog", "cellphone_number": "+4670000001", "country": "SWE", "metadata": {"user_id": 1847}}' https://api.gigapay.se/v2/employees/

fetch("https://api.gigapay.se/v2/employees/", {
    method: "POST",
    body: JSON.stringify({
        name: "Albin Lindskog",
        cellphone_number: "+4670000000",
        country: "SWE",
        metadata: {
          user_id: 1847  
        }
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

Response:

{
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Albin Lindskog",
    "email": null,
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {
        "user_id": 1847
    },
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": null,
    "claimed_at": null,
    "verified_at": null
}

All objects in the Gigapay API have a metadata attribute. You can use this attribute to attach any JSON-serializable data to these objects. It is useful for storing additional information about an object. For example, you could store a unique identifier for an Employee in your system. This data is not used by Gigapay, and will not be displayed to any users.

The Payout object also has a description field. It should contain a human-readable description of why this Payout is being made. Unlike metadata, description is a single string, and the Employee will see it.

Integrations

Integrations are the parent object of all other objects in the Gigapay API. All other objects are separated per Integration, when operating on these objects you thus need to specify which integration you are acting as by providing the Integration-ID header.

There are three types of integrations:

Web App Integration; type 1: The integration used for the web app at app.gigapay.se. There is only one, it can not be deleted.
Invoice Integrations; type 2: Integrations used to manage Invoices sent to you from Freelancers. There is one per Freelancer, they are read-only.
Custom Integrations; type 3: Integrations created and managed by you through the api.

The Integration object

An example Integration object:

{
    "id": "1",
    "name": "Zerebra AB",
    "type": 1,
    "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/zerebra_logo.png",
    "metadata": {},
    "email": "faktura@zerebra.com",
    "recipient": "Zerebra AB",
    "address_line_1": "Svartmangatan 18",
    "address_line_2": null,
    "zip_code": "11129"
}

Attribute	Description
`id`	Unique identifier for the object.
`name`	Name of integration, presented to Employees.
`type`	Type of integrations.
`logo`	Image of logo to use, presented to Employees.
`metadata`	JSON-encoded metadata.
`email`	Email address to send invoices to.
`recipient`	Name of recipient written on invoices.
`address_line_1`	Address line 1 written on invoices.
`address_line_2`	Address line 2 written on invoices.
`zip_code`	Zip code written on invoices
`city`	City written on invoices.

List All Integrations

import requests

response = requests.get(
    'https://api.gigapay.se/v2/integrations/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821'  https://api.gigapay.se/v2/integrations/

fetch("https://api.gigapay.se/v2/integrations/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
    }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/integrations/?page=2",
    "results": [
        {
            "id": "1",
            "name": "Zerebra AB",
            "type": 1,
            "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/zerebra_logo.png",
            "metadata": {},
            "email": "faktura@zerebra.com",
            "recipient": "Zerebra AB",
            "address_line_1": "Svartmangatan 18",
            "address_line_2": null,
            "zip_code": "11129"
        }, {
            "id": "1",
            "name": "Zerebra AB Gig",
            "type": 3,
            "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/zerebra_logo.png",
            "metadata": {},
            "email": "faktura+gig@zerebra.com",
            "recipient": "Zerebra AB",
            "address_line_1": "Svartmangatan 18",
            "address_line_2": null,
            "zip_code": "11129"
        },
    ]
}

This endpoint retrieves all integrations.

HTTP Request

GET https://api.gigapay.se/v2/integrations/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Integrations per page.
`type`		Filter based on type.

Create an Integration

import requests

response = requests.post(
    'https://api.gigapay.se/v2/integrations/',
    json={
        "address_line_1": "Malmvägen 8",
        "city": "Segeltorp",
        "email": "albin@pinestreet.tech",
        "id": "846291712",
        "logo": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=",
        "name": "Pinestreet Tech",
        "recipient": "Pinestreet Technology AB",
        "zip_code": "14171",
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -d '{"address_line_1": "Malmv\u00e4gen 8", "city": "Segeltorp", "email": "albin@pinestreet.tech", "id": "846291712", "logo": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=", "name": "Pinestreet Tech", "recipient": "Pinestreet Technology AB", "zip_code": "14171"}' https://api.gigapay.se/v2/integrations/```

fetch("https://api.gigapay.se/v2/integrations/", {
    method: "POST",
    body: JSON.stringify({
        address_line_1: "Malmvägen 8",
        city: "Segeltorp",
        email: "albin@pinestreet.tech",
        id: "846291712",
        logo: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=",
        name: "Pinestreet Tech",
        recipient: "Pinestreet Technology AB",
        zip_code: "14171",
    }),
    headers: {
        Authorization: "Token cd7a4537a231356d404b553f465b6af2fa035821",
    },
})

The above command returns JSON structured like this:

{
    "id": "14585989-9a6c-4f05-b251-69e38e85d324",
    "name": "Pinestreet Tech",
    "type": 3,
    "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/pinestreet_logo.png",
    "metadata": {},
    "email": "albin@pinestreet.tech",
    "recipient": "Pinestreet Technology AB",
    "address_line_1": "Malmvägen 8",
    "address_line_2": null,
    "zip_code": "14171",
    "city": "Segeltorp"
}

This endpoint creates an Integration.

This endpoints supports both JSON and multipart/form-data encoded requests, to facilitate uploading a logo file.

Only examples with JSON-encoded payload and base64-encoded images are provided, though.

HTTP Request

POST https://api.gigapay.se/v2/integrations/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Globally unique.
`name`	String	True
`logo`	Image	False	null	base64 or multipart/form-data encoded image file.
`metadata`	Object	False	{}
`email`	String	True
`recipient`	String	True
`address_line_1`	Object	True
`address_line_2`	String	False	null
`zip_code`	String	True
`city`	String	True

Retrieve an Integration

import requests

response = requests.get(
    'https://api.gigapay.se/v2/integrations/846291712/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821'  https://api.gigapay.se/v2/integrations/846291712/

fetch("https://api.gigapay.se/v2/integrations/846291712/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
    }
})

The above command returns JSON structured like this:

{
    "id": "846291712",
    "name": "Pinestreet Tech",
    "type": 3,
    "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/pinestreet_logo.png",
    "metadata": {},
    "email": "albin@pinestreet.tech",
    "recipient": "Pinestreet Technology AB",
    "address_line_1": "Malmvägen 8",
    "address_line_2": null,
    "zip_code": "14171",
    "city": "Segeltorp"
}

This endpoint retrieves an Integration.

HTTP Request

GET https://api.gigapay.se/v2/integrations/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Update an Integration

import requests

response = requests.patch(
    'https://api.gigapay.se/v2/integrations/846291712/',
    json={
        'email': 'invoice@pinestreet.tech'
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X PATCH -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -d '{"email": "invoice@pinestreet.tech"} https://api.gigapay.se/v2/integrations/846291712/

fetch("https://api.gigapay.se/v2/integrations/846291712/", {
    method: "PATCH",
    body: JSON.stringify({'email': 'invoice@pinestreet.tech'}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
    },
})

The above command returns JSON structured like this:

{
    "id": "846291712",
    "name": "Pinestreet Tech",
    "type": 3,
    "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/pinestreet_logo.png",
    "metadata": {},
    "email": "albin@pinestreet.tech",
    "recipient": "Pinestreet Technology AB",
    "address_line_1": "Malmvägen 8",
    "address_line_2": null,
    "zip_code": "14171",
    "city": "Segeltorp"
}

This endpoint updates an integration. You may not update Integrations of type 2.

HTTP Request

PATCH https://api.gigapay.se/v2/integrations/:id/

This endpoints supports both JSON and multipart/form-data encoded requests, to facilitate uploading a logo file.

Only examples with JSON-encoded payload and base64-encoded images are provided, though.

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	Previous value	Globally unique.
`name`	String	False	Previous value
`logo`	Image	False	Previous value	base64 or multipart/form-data encoded image file.
`metadata`	Object	False	Previous value
`email`	String	False	Previous value
`recipient`	String	False	Previous value
`address_line_1`	Object	False	Previous value
`address_line_2`	String	False	Previous value
`zip_code`	String	False	Previous value
`city`	String	False	Previous value

Replace an Integration

import requests

response = requests.put(
    'https://api.gigapay.se/v2/integrations/846291712/',
    json={
        "address_line_1": "Malmvägen 8",
        "city": "Segeltorp",
        "email": "albin@pinestreet.tech",
        "id": "846291712",
        "logo": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=",
        "name": "Pinestreet Tech",
        "recipient": "Pinestreet Technology AB",
        "zip_code": "14171",
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X PUT -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -d '{"address_line_1": "Malmv\u00e4gen 8", "city": "Segeltorp", "email": "albin@pinestreet.tech", "id": "846291712", "logo": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=", "name": "Pinestreet Tech", "recipient": "Pinestreet Technology AB", "zip_code": "14171"}' https://api.gigapay.se/v2/integrations/846291712/```

fetch("https://api.gigapay.se/v2/integrations/846291712/", {
    method: "PUT",
    body: JSON.stringify({
        address_line_1: "Malmvägen 8",
        city: "Segeltorp",
        email: "albin@pinestreet.tech",
        id: "846291712",
        logo: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAACnej3aAAAAAXRSTlMAQObYZgAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=",
        name: "Pinestreet Tech",
        recipient: "Pinestreet Technology AB",
        zip_code: "14171",
    }),
    headers: {
        Authorization: "Token cd7a4537a231356d404b553f465b6af2fa035821",
    },
})

The above command returns JSON structured like this:

{
    "id": "846291712",
    "name": "Pinestreet Tech",
    "type": 3,
    "logo": "https://gigapay.ams3.digitaloceanspaces.com/gigapay/pinestreet_logo.png",
    "metadata": {},
    "email": "albin@pinestreet.tech",
    "recipient": "Pinestreet Technology AB",
    "address_line_1": "Malmvägen 8",
    "address_line_2": null,
    "zip_code": "14171",
    "city": "Segeltorp"
}

This endpoint replaces an Integration. You may not replace Integrations of type 2.

HTTP Request

PUT https://api.gigapay.se/v2/integrations/:id/

This endpoints supports both JSON and multipart/form-data encoded requests, to facilitate uploading a logo file.

Only examples with JSON-encoded payload and base64-encoded images are provided, though.

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Globally unique.
`name`	String	True
`logo`	Image	False	null	base64 or multipart/form-data encoded image file.
`metadata`	Object	False	{}
`email`	String	True
`recipient`	String	True
`address_line_1`	Object	True
`address_line_2`	String	False	null
`zip_code`	String	True
`city`	String	True

Delete an Integration

import requests

response = requests.delete(
    'https://api.gigapay.se/v2/integrations/846291712/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
    }
)

curl -X DELETE -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' https://api.gigapay.se/v2/integrations/846291712/

fetch("https://api.gigapay.se/v2/integrations/846291712/", {
    method: "DELETE",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
    }
})

The above command returns an empty response.

This endpoint deletes an Integration. Note that you can not delete Integrations of type 1 or 2, nor Integrations that have objects associated with them.

HTTP Request

DELETE https://api.gigapay.se/v2/integrations/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Employees

An Employee is an individual performing tasks within your organization, employed or sub-contracted by Gigapay. To add an Employee to your organization you can create an Employee object. The Employee will be notified and Gigapay will verify their identity and working permits.

The Employee object

An example Employee object:

{
    "id": "1847",
    "name": "Albin Lindskog",
    "email": "albin@gigapay.co",
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {},
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": "2019-05-22T10:32:37.846274Z",
    "claimed_at": "2019-05-23T11:56:41.123721Z",
    "verified_at": "2019-05-23T11:57:03.742345Z"
}

Attribute	Description
`id`	Unique identifier for the object.
`name`	The full name of the Employee.
`email`	Email address of the Employee.
`country`	Employee's country of residence. ISO-3166 country code.
`cellphone_number`	The Employees cellphone number, including country code.
`metadata`	JSON-encoded metadata.
`created_at`	Time at which the Employee was created at. Displayed as ISO 8601 string.
`notified_at`	Time at which the Employee was notified. Displayed as ISO 8601 string.
`claimed_at`	Time at which the Employee consumed the magic link. Displayed as ISO 8601 string.
`verified_at`	Time when the Employee was verified. Displayed as ISO 8601 string.

List All Employees

import requests

response = requests.get(
    'https://api.gigapay.se/v2/employees/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/employees/

fetch("https://api.gigapay.se/v2/employees/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/employees/?page=2",
    "results": [
        {
            "id": "1847",
            "name": "Albin Lindskog",
            "email": "albin@gigapay.co",
            "cellphone_number": "+46703000000",
            "country": "SWE",
            "metadata": {},
            "created_at": "2019-05-22T10:32:36.118753Z",
            "notified_at": "2019-05-22T10:32:37.846274Z",
            "claimed_at": "2019-05-23T11:56:41.123721Z",
            "verified_at": "2019-05-23T11:57:03.742345Z"
        }, {
            "id": "1848",
            "name": "Joakim Olovsson",
            "email": "joakim@gigapay.co",
            "cellphone_number": "+46703000001",
            "country": "SWE",
            "metadata": {},
            "created_at": "2019-05-23T14:45:12.545271Z",
            "notified_at": "2019-05-23T14:45:13.374627Z",
            "claimed_at": "2019-05-23T14:45:37.282819Z",
            "verified_at": "2019-05-24T09:47:02.918264Z"
        }
    ]
}

This endpoint retrieves all Employees.

HTTP Request

GET https://api.gigapay.se/v2/employees/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Employees per page.
`created_at`		Timestamp filter.
`notified_at`		Timestamp filter.
`claimed_at`		Timestamp filter.
`verified_at`		Timestamp filter.
`search`		Filter by part of name, email or cellphone number.

Register an Employee

import requests

response = requests.post(
    'https://api.gigapay.se/v2/employees/',
    json={
        'id': 1847,
        'name': 'Albin Lindskog',
        'cellphone_number': '+4670000001',
        'email': 'albin@mail.com',
        'country': 'SWE'
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 1847, "name": "Albin Lindskog", "cellphone_number": "+4670000001", "email": "albin@mail.com", "country": "SWE"}' https://api.gigapay.se/v2/employees/

fetch("https://api.gigapay.se/v2/employees/", {
    method: "POST",
    body: JSON.stringify({
        name: "Albin Lindskog",
        cellphone_number: "+4670000000",
        email: "albin@mail.com",
        country: "SWE"
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "14585989-9a6c-4f05-b251-69e38e85d324",
    "name": "Albin Lindskog",
    "email": "albin@gigapay.co",
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {},
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": null,
    "claimed_at": null,
    "verified_at": null
}

This endpoint registers an Employee.

HTTP Request

POST https://api.gigapay.se/v2/employees/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Unique per Integration.
`name`	String	True
`email`	String	False	null	Either `email` or `cellphone_number` is required.
`country`	String	True		ISO-3166 country code where the employee is living and working.
`cellphone_number`	String	False	null	Either `email` or `cellphone_number` is required.
`metadata`	Object	False	{}

Retrieve an Employee

import requests

response = requests.get(
    'https://api.gigapay.se/v2/employees/1847/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/employees/1847/

fetch("https://api.gigapay.se/v2/employees/1847/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "1847",
    "name": "Albin Lindskog",
    "email": "albin@gigapay.co",
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {},
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": "2019-05-22T10:32:37.846274Z",
    "claimed_at": "2019-05-23T11:56:41.123721Z",
    "verified_at": "2019-05-23T11:57:03.742345Z"
}

This endpoint retrieves an employee.

HTTP Request

GET https://api.gigapay.se/v2/employees/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Update an Employee

import requests

response = requests.patch(
    'https://api.gigapay.se/v2/employees/1847/',
    json={
        'id': 8472,
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X PATCH -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 8472}' https://api.gigapay.se/v2/employees/1847/

fetch("https://api.gigapay.se/v2/employees/1847/", {
    method: "PATCH",
    body: JSON.stringify({id: 8472}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    },
})

The above command returns JSON structured like this:

{
    "id": "8472",
    "name": "Albin Lindskog",
    "email": "albin@gigapay.co",
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {},
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": "2019-05-22T10:32:37.846274Z",
    "claimed_at": "2019-05-23T11:56:41.123721Z",
    "verified_at": "2019-05-23T11:57:03.742345Z"
}

This endpoint updates an Employee.

HTTP Request

PATCH https://api.gigapay.se/v2/employees/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	Previous value.	Unique per Integration.
`name`	String	False	Previous value.
`email`	String	False	Previous value.
`country`	String	False	Previous value.	ISO-3166 country code where the employee is living and working.
`cellphone_number`	False	False	Previous value.
`metadata`	Object	False	Previous value.

Replace an Employee

import requests

response = requests.put(
    'https://api.gigapay.se/v2/employees/8472/',
    json={
        'id': 1847,
        'name': 'Albin Lindskog',
        'cellphone_number': '+4670000001',
        'email': 'albin@mail.com',
        'country': 'SWE'
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X PUT -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 1847, "name": "Albin Lindskog", "cellphone_number": "+4670000001", "email": "albin@mail.com", "country": "SWE"}' https://api.gigapay.se/v2/employees/8472/

fetch("https://api.gigapay.se/v2/employees/8472/", {
    method: "PUT",
    body: JSON.stringify({
        id: 1847,
        name: "Albin Lindskog",
        cellphone_number: "+4670000000",
        email: "albin@mail.com",
        country: "SWE"
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "1847",
    "name": "Albin Lindskog",
    "email": "albin@gigapay.co",
    "cellphone_number": "+46703000000",
    "country": "SWE",
    "metadata": {},
    "created_at": "2019-05-22T10:32:36.118753Z",
    "notified_at": null,
    "claimed_at": null,
    "verified_at": null
}

This endpoint replaces an Employee.

HTTP Request

PUT https://api.gigapay.se/v2/employees/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Description
`id`	String	False	uuid4()	Unique per Integration.
`name`	String	True
`email`	String	False	null	Either `email` or `cellphone_number` is required.
`country`	String	True		ISO-3166 country code where the employee is living and working.
`cellphone_number`	String	False	null	Either `email` or `cellphone_number` is required.
`metadata`	Object	False	{}

Delete a Employee

import requests

response = requests.delete(
    'https://api.gigapay.se/v2/employees/1847/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X DELETE -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/employees/1847/

fetch("https://api.gigapay.se/v2/employees/1847/", {
    method: "DELETE",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns an empty response.

This endpoint deletes an Employee. You can not delete an Employee after a Payout has been registered to it.

HTTP Request

DELETE https://api.gigapay.se/v2/employees/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Resend an Invitation

import requests

response = requests.patch(
    'https://api.gigapay.se/v2/employees/1847/resend/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b',
        'Idempotency-key': 'ac4beffd-79b0-4561-b16c-846a9600b168'
    }
)

curl -X PATCH -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -H 'Idempotency-key: ac4beffd-79b0-4561-b16c-846a9600b168' https://api.gigapay.se/v2/employees/1847/resend/

fetch("https://api.gigapay.se/v2/employees/1847/resend/", {
    method: "PATCH",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b",
        "Idempotency-key": "ac4beffd-79b0-4561-b16c-846a9600b168"
    }
})

The above command returns an empty response.

This endpoint resends an invitation. After resending, you need to wait at least 24 hours before resending again.

HTTP Request

PATCH https://api.gigapay.se/v2/employees/:id/resend/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Payouts

To make a payout to an Employee you need to create a Payout object. The Employee is notified of the Payout once the corresponding Invoice is paid. The Employee will need to sign and accept the Payout before it is disbursed to their account.

Either amount, invoiced_amount or cost is used as a basis for the Payout. For their definition and how they are related see Pricing. Ensure that you are using the same definition when communicating with the recipient to align everyone's expectation.

The Payout object

An example Payout object:

{
    "id": "0177270d-f94b-4ab9-88ba-ac1fa2f791aa",
    "amount": "100.00",
    "cost": "137.99",
    "currency": "SEK",
    "description": "Lön genom Gigapay",
    "employee": "1f1d1263-0e79-4787-b573-6df81b44bfc2",
    "invoice": "bab4b830-47d6-4a24-a460-3289897f6e8e",
    "metadata": {},
    "start_at": null,
    "end_at": null,
    "created_at": "2019-05-22T10:32:38.118753Z",
    "notified_at": "2019-05-22T10:38:19.874623Z",
    "accepted_at": null
}

Attribute	Description
`id`	Unique identifier for the object.
`amount`	Decimal formatted string of the gross salary amount.
`invoiced_amount`	Decimal formatted string of the invoiced amount.
`cost`	Decimal formatted string of the total salary cost.
`currency`	ISO-4217 currency code.
`description`	String describing the work done, displayed to the recipient. Max 255 characters.
`full_salary_specification`	Controls whether to present the payroll taxes and Gigapay's fee on the payslip. It is set to false when `amount` is used as a basis for the Payout, true otherwise.
`employee`	Unique identifier for the Employee object, that is the recipient of the Payout. This is an expandable object.
`invoice`	Unique identifier for the Invoice object the Payout object belongs to. This is an expandable object.
`metadata`	JSON-encoded metadata.
`start_at`	The time at which the gig will start. Displayed as ISO 8601 string.
`end_at`	The time at which the gig will end. Displayed as ISO 8601 string.
`created_at`	The time at which the Payout was created at. Displayed as ISO 8601 string.
`notified_at`	The time at which the Employee was notified of the Payout. Displayed as ISO 8601 string.
`accepted_at`	The time at which the Employee accepted the Payout. Displayed as ISO 8601 string.

List All Payouts

import requests

response = requests.get(
    'https://api.gigapay.se/v2/payouts/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/payouts/

fetch("https://api.gigapay.se/v2/payouts/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/payouts/?page=1",
    "results": [
        {
            "id": "0177270d-f94b-4ab9-88ba-ac1fa2f791aa",
            "amount": "100.00",
            "cost": "137.99",
            "currency": "SEK",
            "description": "Lön genom Gigapay",
            "employee": "1f1d1263-0e79-4787-b573-6df81b44bfc2",
            "invoice": "bab4b830-47d6-4a24-a460-3289897f6e8e",
            "metadata": {
                "job_id": 127
            },
            "start_at": null,
            "end_at": null,
            "created_at": "2019-05-22T10:32:38.118753Z",
            "notified_at": "2019-05-22T10:38:19.874623Z",
            "accepted_at": null
        }, {
            "id": "8a726186-a4e4-42e0-b56e-20fd17dc67ba",
            "amount": "10.00",
            "cost": "13.79",
            "currency": "SEK",
            "description": "Lön genom Gigapay",
            "employee": "1f1d1263-0e79-4787-b573-6df81b44bfc2",
            "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
            "metadata": {
              "job_id": 128
            },
            "start_at": "2019-05-22T08:00:00.000000Z",
            "end_at": "2019-05-22T17:00:00.000000Z",
            "created_at": "2019-05-23T10:32:38.118753Z",
            "notified_at": "2019-05-23T11:46:29.298742Z",
            "accepted_at": "2019-05-23T12:02:16.472846Z"
        }
    ]
}

This endpoint retrieves all Payouts.

HTTP Request

GET https://api.gigapay.se/v2/payouts/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Employees per page.
`invoice`		Relational Filter.
`employee`		Relational Filter.
`start_at`		Timestamp filter.
`end_at`		Timestamp filter.
`created_at`		Timestamp filter.
`notified_at`		Timestamp filter.
`accepted_at`		Timestamp filter.
`search`		Find payout by searching for part of payout description or employee: name, cellphone number, email.

Register a Payout

import requests

response = requests.post(
    'https://api.gigapay.se/v2/payouts/',
    json={
        'id': 9472,
        'currency': 'SEK',
        'description': 'Instagram samarbete 2021-11-13.',
        'employee': 1847,
        'invoiced_amount': '1000.00',          
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b'  -d '{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "employee": 1847, "invoiced_amount": "1000.00"}' https://api.gigapay.se/v2/payouts/

fetch("https://api.gigapay.se/v2/payouts/", {
    method: "POST",
    body: JSON.stringify({
        id: 9472,
        currency: 'SEK',
        description: 'Instagram samarbete 2021-11-13.',
        employee: 1847,
        invoiced_amount: '1000.00',       
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "9472",
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "description": "Lön genom Gigapay",
    "employee": "1847",
    "full_salary_specification": true,
    "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
    "invoiced_amount": "1000.00",
    "metadata": {},
    "start_at": null,
    "end_at": null,
    "created_at": "2019-05-23T10:32:38.118753Z",
    "notified_at": null,
    "accepted_at": null
}

This endpoint registers a payout.

HTTP Request

POST https://api.gigapay.se/v2/payouts/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Unique per Integration.
`amount`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`cost`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`currency`	String	True
`description`	String	True
`employee`	String	True
`invoiced_amount`	String	True		Either `amount`, `invoiced_amount` or `cost` is required.
`metadata`	Object	False
`start_at`	String	False
`end_at`	String	False	null

Register multiple Payouts

import requests

response = requests.post(
    'https://api.gigapay.se/v2/payouts/',
    json=[
        {
            'id': 9472,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'employee': 1847,
            'invoiced_amount': '1000.00',
            'metadata': {},            
        }, {
            'id': 9473,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'employee': 1736,
            'invoiced_amount': '2500.00',
            'metadata': {},            
        },
    ],
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '[{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "employee": 1847, "invoiced_amount": "1000.00"}, {"id": 9473, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "employee": 1736, "invoiced_amount": "2500.00"}]' https://api.gigapay.se/v2/payouts/

fetch("https://api.gigapay.se/v2/payouts/", {
    method: "POST",
    body: JSON.stringify([
        {
            'id': 9472,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'employee': 1847,
            'invoiced_amount': '1000.00',
            'metadata': {},            
        }, {
            'id': 9473,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'employee': 1736,
            'invoiced_amount': '2500.00',
            'metadata': {},            
        },
    ]),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

[
    {
        "id": "9472",
        "amount": "760.92",
        "cost": "1020.00",
        "currency": "SEK",
        "description": "Instagram samarbete 2021-11-13.",
        "employee": "1847",
        "full_salary_specification": true,
        "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
        "invoiced_amount": "1000.00",
        "metadata": {},
        "start_at": null,
        "end_at": null,
        "created_at": "2019-05-23T10:32:38.118753Z",
        "notified_at": null,
        "accepted_at": null
    }, {
        "id": "9473",
        "amount": "1902.31",
        "cost": "2550.00",
        "currency": "SEK",
        "description": "Instagram samarbete 2021-11-13.",
        "employee": "1736",
        "full_salary_specification": true,
        "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
        "invoiced_amount": "2500.00",
        "metadata": {},
        "start_at": null,
        "end_at": null,
        "created_at": "2019-05-23T10:32:38.118812Z",
        "notified_at": null,
        "accepted_at": null
    }
]

This endpoint registers multiple Payouts at once. All payouts will be added to the same Invoice object.

HTTP Request

POST https://api.gigapay.se/v2/payouts/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Type	Required	Default	Notes
Payout[]	True		Elements of array structured as Payout.

Register a Payout with an inline Employee

import requests

response = requests.post(
    'https://api.gigapay.se/v2/payouts/?expand=employee',
    json={
        'id': 9472,
        'currency': 'SEK',
        'description': 'Instagram samarbete 2021-11-13.',
        'employee': {
            'id': 1847,
            'name': 'Albin Lindskog',
            'cellphone_number': '+4670000001',
            'email': 'albin@mail.com',
            'country': 'SWE'
        },
        'invoiced_amount': '1000.00',         
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "employee": {"id": 1847, "name": "Albin Lindskog", "cellphone_number": "+4670000001", "email": "albin@mail.com", "country": "SWE"}, "invoiced_amount": "1000.00"}' 'https://api.gigapay.se/v2/payouts/?expand=employee'

fetch("https://api.gigapay.se/v2/payouts/?expand=employee", {
    method: "POST",
    body: JSON.stringify({
        id: 9472,
        currency: 'SEK',
        description: 'Instagram samarbete 2021-11-13.',
        employee: {
            id: 1847,
            name: 'Albin Lindskog',
            cellphone_number: '+4670000001',
            email: 'albin@mail.com',
            country: 'SWE'
        },
        invoiced_amount: '1000.00',       
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "9472",
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "description": "Instagram samarbete 2021-11-13.",
    "employee": {
        "id": "1847",
        "name": "Albin Lindskog",
        "email": "albin@mail.com",
        "cellphone_number": "+46700000001",
        "country": "SWE",
        "metadata": {},
        "created_at": "2019-05-22T10:32:36.118753Z",
        "notified_at": null,
        "claimed_at": null,
        "verified_at": null
    },
    "full_salary_specification": true,
    "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
    "invoiced_amount": "1000.00",
    "metadata": {
        "campaign_id": 12394
    },
    "start_at": null,
    "end_at": null,
    "created_at": "2019-05-23T10:32:38.118753Z",
    "notified_at": null,
    "accepted_at": null
}

This endpoint registers a Payout and an Employee at the same time. If an Employee with matching information is already registered that object will be reused.

HTTP Request

POST https://api.gigapay.se/v2/payouts/?expand=employee

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Unique per Integration.
`amount`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`cost`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`currency`	String	True
`description`	String	True
`employee`	Object	True		Structured as an Employee.
`invoiced_amount`	String	True		Either `amount`, `invoiced_amount` or `cost` is required.
`metadata`	Object	False
`start_at`	String	False
`end_at`	String	False	null

Retrieve a Payout

import requests

response = requests.get(
    'https://api.gigapay.se/v2/payouts/9472/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/payouts/9472/

fetch("https://api.gigapay.se/v2/payouts/9472/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "9472",
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "description": "Lön genom Gigapay",
    "employee": "1847",
    "full_salary_specification": true,
    "invoice": "c1554d88-b74f-4d6a-bfa6-049c14905dc7",
    "invoiced_amount": "1000.00",
    "metadata": {
        "campaign_id": 12394
    },
    "start_at": "2019-05-22T08:00:00.000000Z",
    "end_at": "2019-05-22T17:00:00.000000Z",
    "created_at": "2019-05-23T10:32:38.118753Z",
    "notified_at": "2019-05-23T11:46:29.298742Z",
    "accepted_at": "2019-05-23T12:02:16.472846Z"
}

This endpoint retrieves a payout.

HTTP Request

GET https://api.gigapay.se/v2/payouts/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Delete a Payout

import requests

response = requests.delete(
    'https://api.gigapay.se/v2/payouts/9472/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X DELETE -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/payouts/9472/

fetch("https://api.gigapay.se/v2/payouts/9472/", {
    method: "DELETE",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns an empty response.

Endpoint for deleting a specific Payout. Note that you can not delete a payout belonging to a paid Invoice or an Invoice on credit.

HTTP Request

DELETE https://api.gigapay.se/v2/payouts/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Resend a Notification

import requests

response = requests.put(
    'https://api.gigapay.se/v2/payouts/9472/resend/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b',
        'Idempotency-key': 'ac4beffd-79b0-4561-b16c-846a9600b168'
    }
)

curl -X PUT -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -H 'Idempotency-key: ac4beffd-79b0-4561-b16c-846a9600b168' https://api.gigapay.se/v2/payouts/9472/resend/

fetch("https://api.gigapay.se/v2/payouts/9472/resend/", {
    method: "PUT",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b",
        "Idempotency-key": "ac4beffd-79b0-4561-b16c-846a9600b168"
    }
})

The above command returns an empty response.

This endpoint resends a notification. After resending, you need to wait at least 24 hours before resending again.

HTTP Request

PATCH https://api.gigapay.se/v2/payouts/:id/resend/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Pricing

The Pricing endpoint allows you to calculate the price of payout you would like to make, and to retrieve the price information about previously made payouts. The endpoint is designed to mirror the Payouts endpoint as closely as possible, e.g. the same request can be used to retrieve the price information of a Payout you'd like to make and to actually make it.

The Pricing breakdown

An example Pricing breakdown for a Payout:

{
  "amount": "1000.00",
  "cost": "1379.91",
  "currency": "SEK",
  "fee": "65.71",
  "health_insurance": null,
  "invoiced_amount": "1314.20",
  "payroll": "314.20",
  "pension": null,
  "tax": "300.00",
  "vat": "344.97"
}

Attribute	Description
amount	Decimal formatted string of the gross salary amount.
invoiced_amount	Decimal formatted string of the invoiced amount.
cost	Decimal formatted string of the total salary cost.
currency	ISO-4217 currency code.
fee	Decimal formatted string of Gigapay's fee for this Payout.
health_insurance	Decimal formatted string of the cost of mandated health insurance. Will be none if health insurance is not mandated.
payroll	Decimal formatted string of the payroll taxes. Will be none if payroll taxes are not mandated.
pension	Decimal formatted string of the cost of mandated pension. Will be none if pension is not mandated.
tax	Decimal formatted string of the preliminary income taxes the will be reported and paid on behalf of the recipient.
vat	Decimal formatted string of the VAT for the Payout.

Either amount, invoiced_amount or cost is used as a basis for calculating the Pricing breakdown. One is provided and the other are calculated based on that. Their definitions are:

amount: net amount paid out plus obligations paid by the recipient.
invoiced_amount: amount plus obligations paid by the employer.
cost: invoiced_amount plus Gigapay's fee. This is the final amount you end up paying.

Which of the attributes that are included and in what step varies between countries. Examples of what the pricing looks like in each country are provided.

List Pricing info

import requests

response = requests.get(
    'https://api.gigapay.se/v2/pricing/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/pricing/

fetch("https://api.gigapay.se/v2/pricing/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/pricing/?page=1",
    "results": [
        {
           "amount": "1000.00",
           "cost": "1379.91",
           "currency": "SEK",
           "fee": "65.71",
           "health_insurance": null,
           "invoiced_amount": "1314.20",
           "payroll": "314.20",
           "pension": null,
           "tax": "300.00",
           "vat": "344.97"
        }, {
           "amount": "3000.00",
           "cost": "4139.73",
           "currency": "SEK",
           "fee": "197.13",
           "health_insurance": null, 
           "invoiced_amount": "3942.60",
           "payroll": "942.60",
           "pension": null,
           "tax": "900.00",
           "vat": "1034.93"
        }
   ]
}

List Pricing info for past Payouts.

HTTP Request

GET https://api.gigapay.se/v2/pricing/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Employees per page.
`invoice`		Relational Filter.
`employee`		Relational Filter.
`start_at`		Timestamp filter.
`end_at`		Timestamp filter.
`created_at`		Timestamp filter.
`notified_at`		Timestamp filter.
`accepted_at`		Timestamp filter.

Calculate Pricing info

import requests

response = requests.post(
    'https://api.gigapay.se/v2/pricing/',
    json={
        'id': 9472,
        'currency': 'SEK',
        'description': 'Instagram samarbete 2021-11-13.',
        'full_salary_specification': True,
        'employee': 1847,
        'invoiced_amount': '1000.00',          
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b'  -d '{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "full_salary_specification": true, "employee": 1847, "invoiced_amount": "1000.00"}' https://api.gigapay.se/v2/pricing/

fetch("https://api.gigapay.se/v2/pricing/", {
    method: "POST",
    body: JSON.stringify({
        id: 9472,
        currency: 'SEK',
        description: 'Instagram samarbete 2021-11-13.',
        full_salary_specification: true,
        employee: 1847,
        invoiced_amount: '1000.00',       
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "fee": "20.00",
    "health_insurance": null,
    "invoiced_amount": "1000.00",
    "payroll": "239.18",
    "pension": null,
    "tax": "228.28",
    "vat": "255.00"
}

This endpoint allows you to calculate the price of payout you would like to make.

HTTP Request

POST https://api.gigapay.se/v2/pricing/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Description
`id`	String	False	uuid4()	Unique per Integration.
`amount`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`cost`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`currency`	String	True
`description`	String	True
`employee`	String	True
`full_salary_specification`	Bool	False	False
`invoiced_amount`	String	True		Either `amount`, `invoiced_amount` or `cost` is required.
`metadata`	Object	False
`start_at`	String	False
`end_at`	String	False	null

Calculate bulk pricing info

import requests

response = requests.post(
    'https://api.gigapay.se/v2/payouts/',
    json=[
        {
            'id': 9472,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'full_salary_specification': True,
            'employee': 1847,
            'invoiced_amount': '1000.00',       
        }, {
            'id': 9473,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'full_salary_specification': True,
            'employee': 1736,
            'invoiced_amount': '2500.00',       
        },
    ],
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '[{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "full_salary_specification": true, "employee": 1847, "invoiced_amount": "1000.00"}, {"id": 9473, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "full_salary_specification": true, "employee": 1736, "invoiced_amount": "2500.00"}]' https://api.gigapay.se/v2/payouts/

fetch("https://api.gigapay.se/v2/payouts/", {
    method: "POST",
    body: JSON.stringify([
        {
            'id': 9472,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'full_salary_specification': true,
            'employee': 1847,
            'invoiced_amount': '1000.00',
        }, {
            'id': 9473,
            'currency': 'SEK',
            'description': 'Instagram samarbete 2021-11-13.',
            'full_salary_specification': true,
            'employee': 1736,
            'invoiced_amount': '2500.00',
        },
    ]),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

[
    {
        "amount": "760.92",
        "cost": "1020.00",
        "currency": "SEK",
        "fee": "20.00",
        "health_insurance": null,
        "invoiced_amount": "1000.00",
        "payroll": "239.18",
        "pension": null,
        "tax": "228.28",
        "vat": "255.00"
    }, {
        "amount": "1902.30",
        "cost": "2550.00",
        "currency": "SEK",
        "fee": "50.00",
        "health_insurance": null,
        "invoiced_amount": "2500.00",
        "payroll": "597.95",
        "pension": null,
        "tax": "570.70",
        "vat": "637.50"
    }
]

The same endpoint is used to calculate the pricing info for multiple Payouts at once.

HTTP Request

POST https://api.gigapay.se/v2/pricing/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Type	Required	Default	Notes
Payout[]	True		Elements of array structured as Payout.

Calculate Pricing info with an inline Employee

import requests

response = requests.post(
    'https://api.gigapay.se/v2/pricing/?expand=employee',
    json={
        'id': 9472,
        'currency': 'SEK',
        'description': 'Instagram samarbete 2021-11-13.',
        'full_salary_specification': True,
        'employee': {
            'id': 1847,
            'name': 'Albin Lindskog',
            'cellphone_number': '+4670000001',
            'email': 'albin@mail.com',
            'country': 'SWE'
        },
        'invoiced_amount': '1000.00',        
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": 9472, "currency": "SEK", "description": "Instagram samarbete 2021-11-13.", "full_salary_specification": true, "employee": {"id": 1847, "name": "Albin Lindskog", "cellphone_number": "+4670000001", "email": "albin@mail.com", "country": "SWE"}, "invoiced_amount": "1000.00"}' 'https://api.gigapay.se/v2/pricing/?expand=employee'

fetch("https://api.gigapay.se/v2/pricing/?expand=employee", {
    method: "POST",
    body: JSON.stringify({
        id: 9472,
        currency: 'SEK',
        description: 'Instagram samarbete 2021-11-13.',
        full_salary_specification: true,
        employee: {
            id: 1847,
            name: 'Albin Lindskog',
            cellphone_number: '+4670000001',
            email: 'albin@mail.com',
            country: 'SWE'
        },
        invoiced_amount: '1000.00',       
    }),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "fee": "20.00",
    "health_insurance": null,
    "invoiced_amount": "1000.00",
    "payroll": "239.18",
    "pension": null,
    "tax": "228.28",
    "vat": "255.00"
}

This endpoint registers a Payout and an Employee at the same time. If an Employee with matching information is already registered will the object be reused.

HTTP Request

POST https://api.gigapay.se/v2/payouts/?expand=employee

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Description
`id`	String	False	uuid4()	Unique per Integration.
`amount`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`cost`	String	False		Either `amount`, `invoiced_amount` or `cost` is required.
`currency`	String	True
`description`	String	True
`employee`	Object	True		Structured as an Employee.
`full_salary_specification`	Bool	False	False
`invoiced_amount`	String	True		Either `amount`, `invoiced_amount` or `cost` is required.
`metadata`	Object	False
`start_at`	String	False
`end_at`	String	False	null

Retrieve Pricing info of Payout

import requests

response = requests.get(
    'https://api.gigapay.se/v2/pricing/9472/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/pricing/9472/

fetch("https://api.gigapay.se/v2/pricing/9472/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "amount": "760.92",
    "cost": "1020.00",
    "currency": "SEK",
    "fee": "20.00",
    "health_insurance": null,
    "invoiced_amount": "1000.00",
    "payroll": "239.18",
    "pension": null,
    "tax": "228.28",
    "vat": "255.00"
}

This endpoint retrieves a payout.

HTTP Request

GET https://api.gigapay.se/v2/pricing/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the Payout object.

Invoices

An Invoice groups Payouts together. It is a managed object, you can not create them directly. When a Payout is created it is added to the Invoice that is currently open. If there is no open Invoice, a new will be created.

You can keep invoices open for a certain time period by enabling batching of payouts. Contact support@gigapay.se if you are interested in this.

The Invoice object

An example Invoice object:

{
    "app": "https://app.gigapay.se/i/2859272/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy9jMTMzYzIwMi0xMDUwLTQ5NTktODMwNi05NWQ3Y2IzZjNiMjgvIg",
    "created_at": "2019-05-22T10:32:36.118753Z",
    "currency": "SEK",
    "id": "2859272",
    "metadata": {},
    "ocr_number": "986911160380",
    "open": false,
    "paid_at": "2019-05-25T9:02:16.8462735Z",
    "pdf": "https://api.gigapay.se/invoice/cad7d4d7-cdc7-4f70-8246-c061e041e9e/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy8zYjcyNTYyOS05MTE4LTQ5YTctYTFiYS0yMTU4NTZhMzYwOTgvIg&language=en",
    "price": "1340.48"
}

Attribute	Description
`app`	Link to pay invoice in app.
`created_at`	Time at which the Invoice was created. Displayed as ISO 8601 string.
`currency`	ISO-4217 currency code.
`id`	A unique identifier for the object.
`metadata`	JSON-encoded metadata.
`ocr_number`	Bank reference.
`open`	Whether the Invoice is the currently open one.
`paid_at`	Time at which the Invoice was paid. Displayed as ISO 8601 string.
`pdf`	Link to download a pdf version of the Invoice.
`price`	Decimal formatted string of the price.

List All Invoices

import requests

response = requests.get(
    'https://api.gigapay.se/v2/invoices/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/invoices/

fetch("https://api.gigapay.se/v2/invoices/", {
  headers: {
    "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
    "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
  }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/invoices/?page=1",
    "results": [
        {
            "app": "https://app.gigapay.se/i/2859272/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy9jMTMzYzIwMi0xMDUwLTQ5NTktODMwNi05NWQ3Y2IzZjNiMjgvIg",
            "created_at": "2019-05-22T10:32:36.118753Z",
            "currency": "SEK",
            "id": "2859272",
            "metadata": {},
            "ocr_number": "986911160380",
            "open": false,
            "paid_at": "2019-05-25T9:02:16.8462735Z",
            "pdf": "https://api.gigapay.se/invoice/cad7d4d7-cdc7-4f70-8246-c061e041e9e/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy8zYjcyNTYyOS05MTE4LTQ5YTctYTFiYS0yMTU4NTZhMzYwOTgvIg&language=en",
            "price": "1340.48"
        }, {
            "app": "https://app.gigapay.se/i/2859273/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy9jMTMzYzIwMi0xMDUwLTQ5NTktODMwNi05NWQ3Y2IzZjNiMjgvIg",
            "created_at": "2019-06-22T10:28:21.847474Z",
            "currency": "SEK",
            "id": "2859273",
            "metadata": {},
            "ocr_number": "986911160349",
            "open": false,
            "paid_at": "2019-06-25T9:12:57.742648Z",
            "pdf": "https://api.gigapay.se/invoice/cad7d4d7-cdc7-4f70-8246-c061e041e9e/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy8zYjcyNTYyOS05MTE4LTQ5YTctYTFiYS0yMTU4NTZhMzYwOTgvIg&language=en",
            "price": "1340.48"
        }
}

This endpoint retrieves all Invoices.

HTTP Request

GET https://api.gigapay.se/v2/invoices/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Invoices per page.
`created_at`		Timestamp filter.
`paid_at`		Timestamp filter.

Retrieve an Invoice

import requests

response = requests.get(
    'https://api.gigapay.se/v2/invoices/2859272/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/invoices/2859272/

fetch("https://api.gigapay.se/v2/invoices/2859272/", {
  headers: {
    "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
    "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
  }
})

The above command returns JSON structured like this:

{
    "app": "https://app.gigapay.se/i/2859272/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy9jMTMzYzIwMi0xMDUwLTQ5NTktODMwNi05NWQ3Y2IzZjNiMjgvIg",
    "created_at": "2019-05-22T10:32:36.118753Z",
    "currency": "SEK",
    "id": "2859272",
    "metadata": {},
    "ocr_number": "986911160380",
    "open": false,
    "paid_at": "2019-05-25T9:02:16.8462735Z",
    "pdf": "https://api.gigapay.se/invoice/cad7d4d7-cdc7-4f70-8246-c061e041e9e/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy8zYjcyNTYyOS05MTE4LTQ5YTctYTFiYS0yMTU4NTZhMzYwOTgvIg&language=en",
    "price": "1340.48"
}

This endpoint retrieves an Invoice.

HTTP Request

GET https://api.gigapay.se/v2/invoices/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Update an Invoice

import requests

response = requests.patch(
    'https://api.gigapay.se/v2/invoices/2859272/',
    json={
      'id': '846271',
      'metadata': {'original_id': '2859272'}
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X PATCH -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"id": "846271", "metadata": {"original_id": "2859272"}}' https://api.gigapay.se/v2/invoices/2859272/

fetch("https://api.gigapay.se/v2/invoices/2859272/", {
    method: "PATCH",
    body: JSON.stringify({'id': '846271', 'metadata': {'original_id': '2859272'}}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    },
})

The above command returns JSON structured like this:

{
    "app": "https://app.gigapay.se/i/2859272/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy9jMTMzYzIwMi0xMDUwLTQ5NTktODMwNi05NWQ3Y2IzZjNiMjgvIg",
    "created_at": "2019-05-22T10:32:36.118753Z",
    "currency": "SEK",
    "id": "846271",
    "metadata": {
        "original_id": "2859272"
    },
    "ocr_number": "986911160380",
    "open": false,
    "paid_at": "2019-05-25T9:02:16.8462735Z",
    "pdf": "https://api.gigapay.se/invoice/cad7d4d7-cdc7-4f70-8246-c061e041e9e/?token=Ii9pbnZvaWNpbmcvb3Blbl9pbnZvaWNlcy8zYjcyNTYyOS05MTE4LTQ5YTctYTFiYS0yMTU4NTZhMzYwOTgvIg&language=en",
    "price": "1340.48"
}

This endpoint updates an Invoice.

HTTP Request

PATCH https://api.gigapay.se/v2/invoices/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	Previous value	Unique per Integration.
`metadata`	Object	False	Previous value

Delete an Invoice

import requests

response = requests.delete(
    'https://api.gigapay.se/v2/invoices/846271/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X DELETE -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/invoices/846271/

fetch("https://api.gigapay.se/v2/invoices/846271/", {
    method: "DELETE",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns an empty response.

This endpoint deletes an Invoice. Note that you can not delete a paid Invoice or an Invoice on credit.

HTTP Request

DELETE https://api.gigapay.se/v2/invoices/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Webhooks

Webhooks allows you to receive real-time status updates any time an event happens on your account. For a complete description of these notifications, see Events.

The Webhook object

An example Webhook object

{
    "id": "38a93e19-886a-4246-9cfe-471214ff6739",
    "url": "https://jobmatchr.se/webhooks/payouts/",
    "events": ["Payout.notified", "Payout.accepted"],
    "secret_key": "c1329a085d65f7757838df5920fdcc9a",
    "metadata": {}
}

Attribute	Description
`id`	Unique identifier for the object.
`url`	URL to which the notifications are posted.
`events`	List of events to subscribe to.
`secret_key`	Secret key used to sign the Webhook notifications.
`metadata`	JSON-encoded metadata.

List All Registered Webhooks

import requests

response = requests.get(
    'https://api.gigapay.se/v2/webhooks/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/webhooks/

fetch("https://api.gigapay.se/v2/webhooks/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "count": 4,
    "next": null,
    "previous": "https://api.gigapay.se/v2/webhooks/?page=2",
    "results": [
        {
            "id": "38a93e19-886a-4246-9cfe-471214ff6739",
            "url": "https://jobmatchr.se/webhooks/payouts/",
            "events": ["Payout.notified", "Payout.accepted"],
            "secret_key": "c1329a085d65f7757838df5920fdcc9a",
            "metadata": {}
        }, {
            "id": "0630bfcf-ad0a-458a-9794-816b54b542b6",
            "url": "https://jobmatchr.se/webhooks/employees/",
            "events": ["Employee.verified"],
            "secret_key": "1fc0ee40ecf33f83cbd3f930443074ca",
            "metadata": {}
        }
    ]
}

This endpoint retrieves all webhooks.

HTTP Request

GET https://api.gigapay.se/v2/webhooks/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

Query Parameters

Parameter	Default	Description
`page`	1	Which page to return.
`page_size`	25	The number of Webhooks per page.

Register a Webhook

import requests

response = requests.post(
    'https://api.gigapay.se/v2/webhooks/',
    json={
        'url': 'https://jobmatchr.se/webhooks/payouts/', 
        'events': ['Payout.created']
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X POST -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"url": "http://0.0.0.0:8000/", "events": ["Payout.created"]}' https://jobmatchr.se/webhooks/payouts/

fetch("https://api.gigapay.se/v2/webhooks/", {
    method: "POST",
    body: JSON.stringify({url: "https://jobmatchr.se/webhooks/payouts/", events: ["Payout.created"]}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    },
})

The above command returns JSON structured like this:

{
    "id": "38a93e19-886a-4246-9cfe-471214ff6739",
    "url": "https://jobmatchr.se/webhooks/payouts/",
    "events": ["Payout.created"],
    "secret_key": "c1329a085d65f7757838df5920fdcc9a",
    "metadata": {}
}

This endpoint creates a webhook.

HTTP Request

POST https://api.gigapay.se/v2/webhooks/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.
`Idempotency-key`	False	Idempotency key.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	uuid4()	Unique per Integration.
`url`	URL	True
`events`	String[]	True
`secret_key`	String	False	32 char random string
`metadata`	Object	False	{}

Retrieve a Webhook

import requests

response = requests.get(
    'https://api.gigapay.se/v2/webhooks/481272/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X GET -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/webhooks/481272/

fetch("https://api.gigapay.se/v2/webhooks/481272/", {
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "38a93e19-886a-4246-9cfe-471214ff6739",
    "url": "https://jobmatchr.se/webhooks/payouts/",
    "events": ["Payout.created"],
    "secret_key": "c1329a085d65f7757838df5920fdcc9a",
    "metadata": {}
}

This endpoint retrieves a webhook.

HTTP Request

GET https://api.gigapay.se/v2/webhooks/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Update a Webhook

import requests

response = requests.patch(
    'https://api.gigapay.se/v2/webhooks/481272/',
    json={
        'events': ['Payout.created', 'Payout.notified']
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X PATCH -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"events": ["Payout.created", "Payout.notified"]}' https://api.gigapay.se/v2/webhooks/481272/

fetch("https://api.gigapay.se/v2/webhooks/481272/", {
    method: "PATCH",
    body: JSON.stringify({events: ["Payout.created", "Payout.notified"]}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    },
})

The above command returns JSON structured like this:

{
    "id": "481272",
    "url": "https://jobmatchr.se/webhooks/payouts/",
    "events": ["Payout.created", "Payout.notified"],
    "secret_key": "c1329a085d65f7757838df5920fdcc9a",
    "metadata": {}
}

This endpoint updates a webhook.

HTTP Request

PATCH https://api.gigapay.se/v2/webhooks/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Notes
`id`	String	False	Previous value	Unique per Integration.
`url`	URL	False	Previous value
`events`	String[]	False	Previous value
`secret_key`	String	False	Previous value
`metadata`	Object	False	Previous value

Replace a Webhook

import requests

response = requests.put(
    'https://api.gigapay.se/v2/webhooks/481272/',
    json={
        'url': 'https://jobmatchr.se/webhooks/invoiced/', 
        'events': ['Invoice.created']
    },
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X PUT -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Content-Type: application/json' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' -d '{"url": "https://jobmatchr.se/webhooks/invoiced/", "events": ["Invoice.created"]}' https://api.gigapay.se/v2/webhooks/481272/

fetch("https://api.gigapay.se/v2/webhooks/481272/", {
    method: "PUT",
    body: JSON.stringify({url: "https://jobmatchr.se/webhooks/invoiced/", events: ["Invoice.created"]}),
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Content-Type": "application/json",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns JSON structured like this:

{
    "id": "481272",
    "url": "https://jobmatchr.se/webhooks/invoices/",
    "events": ["Invoice.created"],
    "secret_key": "vksnrsc6tamq73tc26rzrnzf33a4pgdv",
    "metadata": {}
}

{
    "id": "481272",
    "url": "https://jobmatchr.se/webhooks/invoices/",
    "events": ["Invoice.created"],
    "secret_key": "vksnrsc6tamq73tc26rzrnzf33a4pgdv",
    "metadata": {}
}

This endpoint replaces a webhook.

HTTP Request

PUT https://api.gigapay.se/v2/webhooks/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.

Body Parameters

Parameter	Type	Required	Default	Description
`id`	String	False	uuid4()	Unique per Integration.
`url`	URL	True
`events`	String[]	True
`secret_key`	String	False	32 char random string
`metadata`	Object	False	{}

Delete a Webhook

import requests

response = requests.delete(
    'https://api.gigapay.se/v2/webhooks/481272/',
    headers={
        'Authorization': 'Token cd7a4537a231356d404b553f465b6af2fa035821',
        'Integration-ID': '79606358-97af-4196-b64c-5f719433d56b'
    }
)

curl -X DELETE -H 'Authorization: Token cd7a4537a231356d404b553f465b6af2fa035821' -H 'Integration-ID: 79606358-97af-4196-b64c-5f719433d56b' https://api.gigapay.se/v2/webhooks/481272/

fetch("https://api.gigapay.se/v2/webhooks/481272/", {
    method: "DELETE",
    headers: {
        "Authorization": "Token cd7a4537a231356d404b553f465b6af2fa035821",
        "Integration-Id": "79606358-97af-4196-b64c-5f719433d56b"
    }
})

The above command returns an empty response.

This endpoint deletes a webhook.

HTTP Request

DELETE https://api.gigapay.se/v2/webhooks/:id/

Headers

Parameter	Required	Description
`Authorization`	True	Your Authorization Token.
`Integration-ID`	True	Integration id.

URL Parameters

Parameter	Required	Description
`id`	True	Unique identifier for the object.