Finance API

Overview

This page covers the methods and endpoints associated with finance operations. With the Finance API you can access and manage VLD fees.

Authentication

Use the following header parameters for all requests:

Headers
Authentication string required	Authentication bearer token See Authentication Guide
X-IAA-OW-ID integer required	Organization Workspace ID Header

Finance Details

Get Customer PLD Finance Details

GET /api/v3/fa/customer/{customerOwId}/pld-fees

Get finance details for Customer PLD.

Path Parameters
customerOwId integer	Customer Organization Workspace ID

Response Properties

id integer	Customer ID
owId integer	Organization Workspace ID
pldRate integer	PLD rate for workspace Customer
pldMarkupTypeId integer	PLD markup type ID to represent markup types: Absolute or Percentage
pldMarkupValue integer	PLD markup value for Advertiser Customer

JSON

Response 200

{
    "success": true,
    "data": {
        "id": 1,
        "pldRate": 3
    }
}

Response 200 (PLD flag)

{
    "success": true,
    "data": {
        "id": 3,
        "owId": 201427,
        "pldRate": 3,
        "pldEnabled": true,
        "pldMarkupType": "Percentage",
        "pldMarkupValue": 10
    }
}

TypeScript

See TypeScript Prerequisites for usage.

import {
  getInstance
} from "prerequisites"

const axios = getInstance();

interface Responses {
  200: {
    headers: {
      [name: string]: unknown;
    };
    content: {
      "application/json": {
        success: boolean;
        data: {
          id: number;
          vldRate: number;
        }
      }
    };
  };
}

function getPLDFees(): Promise<Responses> {
  const options = {
    method: 'GET',
    url: 'https://app.iqm.com/api/v3/fa/customer/{customerOwId}/pld-fees',
    params: {
      path: {
        customerowId: `number`
      }
    }
  };

  return axios.request(options).then(({ data }: { data: Responses }) => data);
}

---

Updates Customer PLD Details

PATCH /api/v3/fa/customer/pld-fees

Request Schema
id integer	ID
owId integer	OW ID of the Customer to update details (required)
pldRate integer	PLD rate for workspace Customer
pldEnabled boolean	Boolean flag to enable and disable PLD feature for Advertiser Customer
pldMarkupTypeId integer	PLD markup type ID to represent markup types: Absolute or Percentage
pldMarkupValue integer	PLD markup value for Advertiser Customer

Response Properties

id integer	ID
message string	Success message

JSON

Request Sample

{
    "id": 0,
    "owId": 0,
    "pldRate": 0,
    "pldEnabled": true,
    "pldMarkupType": "string",
    "pldMarkupTypeId": 0,
    "pldMarkupValue": 9999
}

Response 200

{
    "success": true,
    "data": {
        "id": 1,
        "message": "PLD Rate updated successfully. The new rate applies only to newly created VLDs"
    }
}

TypeScript

See TypeScript Prerequisites for usage.

import {
  getInstance
} from "prerequisites"

const axios = getInstance();

interface Responses {
  200: {
    headers: {
      [name: string]: unknown;
    };
    content: {
      "application/json": {
        id: number;
        owId: number;
        pldRate: number;
        pldEnabled: boolean;
        pldMarkupType: string;
        pldMarkupTypeId: number;
        pldMarkupValue: number;
      }
    };
  };
}

function editPLDFees(): Promise<Responses> {
  const options = {
    method: 'PATCH',
    url: 'https://app.iqm.com/api/v3/fa/customer/pld-fees',
    requestBody: {
      content: {
        "application/json": {
          id?: `number`,
          owId: `number`,
          pldRate?: `number`,
          pldEnabled?: `boolean`,
          pldMarkupType?: `string`,
          pldMarkupTypeId?: `number`,
          pldMarkupValue?: `number`,
        }
      }
    }
  };

  return axios.request(options).then(({ data }: { data: Responses }) => data);
}

---

Get Customer SLS Finance Details

GET /api/v3/fa/customer/{customerOwId}/sls-fees

Get finance details for Customer SLS.

Path Parameters
customerOwId integer	Customer Organization Workspace ID

Response Properties

id integer	Customer ID
owId integer	Organization Workspace ID
slsRate integer	SLS rate for workspace Customer
slsMarkupTypeId integer	SLS markup type ID to represent markup types: Absolute or Percentage
slsMarkupValue integer	SLS markup value for Advertiser Customer

JSON

Response 200

{
    "success": true,
    "data": {
        "id": 1,
        "slsRate": 3
    }
}

Response 200 (SLS flag)

{
    "success": true,
    "data": {
        "id": 3,
        "owId": 201427,
        "slsRate": 3,
        "slsEnabled": true,
        "slsMarkupType": "Percentage",
        "slsMarkupValue": 10
    }
}

TypeScript

See TypeScript Prerequisites for usage.

import {
  getInstance
} from "prerequisites"

const axios = getInstance();

interface Responses {
  200: {
    headers: {
      [name: string]: unknown;
    };
    content: {
      "application/json": {
        success: boolean;
        data: {
          id: number;
          slsRate: number;
        }
      }
    };
  };
}

function getSLSFees(): Promise<Responses> {
  const options = {
    method: 'GET',
    url: 'https://app.iqm.com/api/v3/fa/customer/{customerOwId}/sls-fees',
    params: {
      path: {
        customerowId: `number`
      }
    }
  };

  return axios.request(options).then(({ data }: { data: Responses }) => data);
}

---

Updates Customer SLS Details

PATCH /api/v3/fa/customer/sls-fees

Request Schema
id integer	ID
owId integer	OW ID of the Customer to update details (required)
slsRate integer	SLS rate for workspace Customer
slsEnabled boolean	Boolean flag to enable and disable SLS feature for Advertiser Customer
slsMarkupTypeId integer	SLS markup type ID to represent markup types: Absolute or Percentage
slsMarkupValue integer	SLS markup value for Advertiser Customer

Response Properties

id integer	ID
message string	Success message

JSON

Request Sample

{
    "id": 0,
    "owId": 0,
    "slsRate": 0,
    "slsEnabled": true,
    "slsMarkupType": "string",
    "slsMarkupTypeId": 0,
    "slsMarkupValue": 9999
}

Response 200

{
    "success": true,
    "data": {
        "id": 1,
        "message": "SLS Rate updated successfully. The new rate applies only to newly created VLDs"
    }
}

TypeScript

See TypeScript Prerequisites for usage.

import {
  getInstance
} from "prerequisites"

const axios = getInstance();

interface Responses {
  200: {
    headers: {
      [name: string]: unknown;
    };
    content: {
      "application/json": {
        id: number;
        owId: number;
        slsRate: number;
        slsEnabled: boolean;
        slsMarkupType: string;
        slsMarkupTypeId: number;
        slsMarkupValue: number;
      }
    };
  };
}

function editSLSFees(): Promise<Responses> {
  const options = {
    method: 'PATCH',
    url: 'https://app.iqm.com/api/v3/fa/customer/sls-fees',
    requestBody: {
      content: {
        "application/json": {
          id?: `number`,
          owId: `number`,
          slsRate?: `number`,
          slsEnabled?: `boolean`,
          slsMarkupType?: `string`,
          slsMarkupTypeId?: `number`,
          slsMarkupValue?: `number`,
        }
      }
    }
  };

  return axios.request(options).then(({ data }: { data: Responses }) => data);
}

---