Call registers

Find available callregister files and download the ones you choose.

Method	HTTP request	Description
GET	https://api.sm-mega.fi/registers/list?id=id&key=key&pass=pass&output=output	Returns the list of downloadable callregisters. * id - Personal id-number. * key - Personal api-key. * pass - Personal api-pass. hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true output - Optional. Method of output. Available options: json, csv or excel. Default output is json. * = required
GET	https://api.sm-mega.fi/registers/get?id=id&key=key&pass=pass&campaign=campaign&filename=filename&output=output	Returns the selected callregister. * id - Personal id-number. * key - Personal api-key. * pass - Personal api-pass. * campaign - Id-number of campaign from where to get callregister. * filename - Filename of campaign. fields 1) - Optional. Use only when you don't want to get all columns or you want to mix the order of columns. Usage: fields=field1;field2;field3 hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true output - Optional. Method of output. Available options: json, csv or excel. Default output is json. * = required 1) Available fields: id, campaigns_id, businessid, business, name, surname, address, postal, city, phone, phone_other, phone_other2, phone_other3, www, email, source, filename, disposition, calldate and callnum. There are also dynamic fields available. They can be used by their dynamic names or hardcoded names: extra1, extra2, extra3 ... extra39, extra40. Available fieldnames are possible to get by defining fields on url without any values.

Method

HTTP request

Description

GET

https://api.sm-mega.fi/registers/list?id=id&key=key&pass=pass&output=output

Returns the list of downloadable callregisters.

* id - Personal id-number.
* key - Personal api-key.
* pass - Personal api-pass.
hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true
output - Optional. Method of output. Available options: json, csv or excel. Default output is json.

* = required

GET

https://api.sm-mega.fi/registers/get?id=id&key=key&pass=pass&campaign=campaign&filename=filename&output=output

Returns the selected callregister.

* id - Personal id-number.
* key - Personal api-key.
* pass - Personal api-pass.
* campaign - Id-number of campaign from where to get callregister.
* filename - Filename of campaign.
fields

- Optional. Use only when you don't want to get all columns or you want to mix the order of columns. Usage: fields=field1;field2;field3
hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true
output - Optional. Method of output. Available options: json, csv or excel. Default output is json.

* = required

Available fields: id, campaigns_id, businessid, business, name, surname, address, postal, city, phone, phone_other, phone_other2, phone_other3, www, email, source, filename, disposition, calldate and callnum.
There are also dynamic fields available. They can be used by their dynamic names or hardcoded names: extra1, extra2, extra3 ... extra39, extra40. Available fieldnames are possible to get by defining fields on url without any values.

Orders

Get the orders

Method	HTTP request	Description
GET	https://api.sm-mega.fi/orders/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output	Returns the orders from the campaigns. * id - Personal id-number. * key - Personal api-key. * pass - Personal api-pass. * begin 1) - Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). * end 1) - Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). begintime - Optional. Starttime of download query. Format HHMM (example: 0806). endtime - Optional. Endtime of download query. Format HHMM (example: 0806). campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined. orders_id - Optional. Id-number of an order. Result will return the single selected order. fields 2) - Optional. Use only when you don't want to get all columns or you want to mix the order of columns. Usage: fields=field1;field2;field3;_empty_;field4 values - Optional. If you want static results to specific title. Usage: values=field1;static text;field2:another static text;_empty_:yet another static text titles - Optional. Use only when you want to change titles to custom ones. Usage: titles=oldtitle:newtitle;other_oldtitle:cool_newtitle hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true record - Optional. Default value is false. When defined true then name of recorded call without path will appear. Usage: record=true record_url - Optional. Default value is false. When defined true then link to last recorded phonecall will appear. Usage: record_url=true receipt - Optional. Default value is false. When defined true then link to last recorded voicereceipt will appear. Usage: receipt=true receipt_url - Optional. Default value is false. When defined true then name of last recorded voicereceipt will appear without path. Usage: receipt_url=true productname_contains - Optional. When defined, results will have only orders where productname contains defined string. Usage: productname_contains=magazineName productname_excludes - Optional. When defined, results will have orders where productname does not contain defined string. Usage: productname_contains=magazineName e164 - Optional. Default value is false. When defined true then phonenumbers starting with zero will be modified to start with +358. Usage: e164=true hideempty - Optional. Default value is false. When defined true then titles of empty answers will be hidden. Usage: hideempty=true confirmed - Optional. Default value is false. When defined true then will return orders that are postconfirmed and orders that do not need postconfirmation. Usage: confirmation=true capitalize - Optional. List of cell's to be capitalized. Usage: capitalize=surname;city available_fields - Optional. Default value is not defined. When defined true then shows available fields only. Option overrides the field option restrictions. available_fields=true dateformat - Optional. Default value is not defined. Define with PHP's date function variables ex. Y-m-d. Affects only to created cell. output - Optional. Method of output. Available options: json, csv or excel. Default output is json. * = required 1) Besides of using exact dates you can use unsigned numeric values. 0 is today, 1 is yesterday and 2 is day before that etc etc. 2) Available fields: id, campaigns_id, businessid, business, name, surname, address, postal, city, phone, phone_other, phone_other2, phone_other3, www, email, source, filename, disposition, calldate and callnum. There are also dynamic fields available. They can be used by their dynamic names or hardcoded names: extra1, extra2, extra3 ... extra39, extra40. Available fieldnames are possible to get by defining fields on url without any values. You can also add empty field using fieldname _empty_.

Method

HTTP request

Description

GET

https://api.sm-mega.fi/orders/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output

Returns the orders from the campaigns.

* id - Personal id-number.
* key - Personal api-key.
* pass - Personal api-pass.
* begin

- Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
* end

- Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
begintime - Optional. Starttime of download query. Format HHMM (example: 0806).
endtime - Optional. Endtime of download query. Format HHMM (example: 0806).
campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined.
orders_id - Optional. Id-number of an order. Result will return the single selected order.
fields

- Optional. Use only when you don't want to get all columns or you want to mix the order of columns. Usage: fields=field1;field2;field3;_empty_;field4
values - Optional. If you want static results to specific title. Usage: values=field1;static text;field2:another static text;_empty_:yet another static text
titles - Optional. Use only when you want to change titles to custom ones. Usage: titles=oldtitle:newtitle;other_oldtitle:cool_newtitle
hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true
record - Optional. Default value is false. When defined true then name of recorded call without path will appear. Usage: record=true
record_url - Optional. Default value is false. When defined true then link to last recorded phonecall will appear. Usage: record_url=true
receipt - Optional. Default value is false. When defined true then link to last recorded voicereceipt will appear. Usage: receipt=true
receipt_url - Optional. Default value is false. When defined true then name of last recorded voicereceipt will appear without path. Usage: receipt_url=true
productname_contains - Optional. When defined, results will have only orders where productname contains defined string. Usage: productname_contains=magazineName
productname_excludes - Optional. When defined, results will have orders where productname does not contain defined string. Usage: productname_contains=magazineName
e164 - Optional. Default value is false. When defined true then phonenumbers starting with zero will be modified to start with +358. Usage: e164=true
hideempty - Optional. Default value is false. When defined true then titles of empty answers will be hidden. Usage: hideempty=true
confirmed - Optional. Default value is false. When defined true then will return orders that are postconfirmed and orders that do not need postconfirmation. Usage: confirmation=true
capitalize - Optional. List of cell's to be capitalized. Usage: capitalize=surname;city
available_fields - Optional. Default value is not defined. When defined true then shows available fields only. Option overrides the field option restrictions. available_fields=true
dateformat - Optional. Default value is not defined. Define with PHP's date function variables ex. Y-m-d. Affects only to created cell.
output - Optional. Method of output. Available options: json, csv or excel. Default output is json.

* = required

Besides of using exact dates you can use unsigned numeric values. 0 is today, 1 is yesterday and 2 is day before that etc etc.

Completed

Import completed callingcards

Method	HTTP request	Description
GET	https://api.sm-mega.fi/completed/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output	Returns the orders from the campaigns. * id - Personal id-number. * key - Personal api-key. * pass - Personal api-pass. * begin 1) - Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). * end 1) - Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). begintime - Optional. Starttime of download query. Format HHMM (example: 0806). endtime - Optional. Endtime of download query. Format HHMM (example: 0806). campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined. exclude_campaign - Optional. Id-numbers of campaigns to not include. Usage: campaigns_exclude=1234;3456;6789. reason - Optional. Status of completeness. 1 = Don't order. 2 = Already customer. 3 = Wrong number. 4. = Not contacted. Without parameter all statuses (except 4) will returned. fields 2) - Optional. Use only when you don't want to get all columns or you want to mix the order of columns. Usage: fields=field1;field2;field3;_empty_;field4 values - Optional. If you want static results to specific title. Usage: values=field1;static text;field2:another static text;_empty_:yet another static text titles - Optional. Use only when you want to change titles to custom ones. Usage: titles=oldtitle:newtitle;other_oldtitle:cool_newtitle hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true e164 - Optional. Default value is false. When defined true then phonenumbers starting with zero will be modified to start with +358. Usage: e164=true hideempty - Optional. Default value is false. When defined true then titles of empty answers will be hidden. Usage: hideempty=true available_fields - Optional. Default value is not defined. When defined true then shows available fields only. Option overrides the field option restrictions. available_fields=true dateformat - Optional. Default value is not defined. Define with PHP's date function variables ex. Y-m-d. Affects only to created and completed cell. output - Optional. Method of output. Available options: json, csv or excel. Default output is json. * = required 1) Besides of using exact dates you can use unsigned numeric values. 0 is today, 1 is yesterday and 2 is day before that etc etc. 2) Available fields: id, campaigns_id, businessid, business, name, surname, address, postal, city, phone, phone_other, phone_other2, phone_other3, www, email, source, filename, disposition, calldate and callnum. There are also dynamic fields available. They can be used by their dynamic names or hardcoded names: extra1, extra2, extra3 ... extra39, extra40. Available fieldnames are possible to get by defining fields on url without any values. You can also add empty field using fieldname _empty_.

Method

HTTP request

Description

GET

https://api.sm-mega.fi/completed/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output

Returns the orders from the campaigns.

* id - Personal id-number.
* key - Personal api-key.
* pass - Personal api-pass.
* begin

- Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
* end

- Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
begintime - Optional. Starttime of download query. Format HHMM (example: 0806).
endtime - Optional. Endtime of download query. Format HHMM (example: 0806).
campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined.
exclude_campaign - Optional. Id-numbers of campaigns to not include. Usage: campaigns_exclude=1234;3456;6789.
reason - Optional. Status of completeness. 1 = Don't order. 2 = Already customer. 3 = Wrong number. 4. = Not contacted. Without parameter all statuses (except 4) will returned.
fields

* = required

Besides of using exact dates you can use unsigned numeric values. 0 is today, 1 is yesterday and 2 is day before that etc etc.

Statistics

Get the statistics of campaign operational data

Method	HTTP request	Description
GET	https://api.sm-mega.fi/statistics/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output	Returns the statistics from the campaigns. * id - Personal id-number. * key - Personal api-key. * pass - Personal api-pass. * begin - Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). * end - Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.). campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined. hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true full - Optional. Default value is false. Disposition data will be more comprehensive when defined true. Usage: full=true output - Optional. Method of output. Available options: json, csv or excel. Default output is json. * = required Response fields are euros, orders, no, false, already, contacts.

Method

HTTP request

Description

GET

https://api.sm-mega.fi/statistics/get?id=id&key=key&pass=pass&begin=begin&end=end&output=output

Returns the statistics from the campaigns.

* id - Personal id-number.
* key - Personal api-key.
* pass - Personal api-pass.
* begin - Startdate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
* end - Enddate of download query. Format Y-m-d (example: 2025-11-08). Also integer can be used (0=today, 1=yesterday, etc.).
campaign - Optional. Id-number of campaign from where to get orders. Result will give orders from all campaigns when not defined.
hidetitles - Optional. Default value is false. When defined true no titles exists on output. Usage: hidetitles=true
full - Optional. Default value is false. Disposition data will be more comprehensive when defined true. Usage: full=true
output - Optional. Method of output. Available options: json, csv or excel. Default output is json.

* = required

Response fields are euros, orders, no, false, already, contacts.