API request configuration

Default request and API behaviour

The URL for default requests to the Candidate Replies Export API is:

https://g2.lmc.cz/export/custom_path/export?login=login_name&password=password&type=3

It consists of:

  • API URL: Unique for each company’s Teamio account, defined by the assigned identifier in the custom_path variable.
  • Login and password parameters: Used for basic authentication; credentials provided after API activation must be used as their values.
  • Type parameter: Will always be set to “3” for Candidate Replies Export API.

By default, this API returns candidate replies from the last 5 days.

Time range specification

For receiving candidate replies from a different time range than the default 5 days, add the following parameters to the URL of your API request:

  • from – Start date (format: YYYY-MM-DD)
  • until – End date (format: YYYY-MM-DD)
  • fromTime – Start time (format: HH-MM)
  • untilTime – End time (format: HH-MM)

Examples:

Limitation by day:

https://g2.lmc.cz/export/custom_path/export?login=login_name&password=password&type=3**&from=2025-09-20&until=2025-09-21**

Limitation by day and exact time:

https://g2.lmc.cz/export/custom_path/export?login=login_name&password=password&type=3**&from=2025-03-10&fromTime=13-00&until=2025-03-11&untilTime=13-00**

Note: URL setup shown in the examples is typically used when candidate replies are retrieved once a day and only new replies since the previous request are needed.

API limitations

Replies per response limit

The maximum number of candidate replies this API can return in a single response is 200.

If the API would need to return more than 200 replies based on your request, it will respond with an error indicating that you must reduce the requested export to a smaller time range using the from and until parameters, or additionally fromTime and untilTime.

Recommendation: When using this API for companies with high application volumes, schedule calls with a short enough time range set. This prevents exceeding the 200-reply limit, which would cause failure of the candidate replies transfer to the destination system.

API call frequency limit

You can call our API at any time, but no more frequently than every 15 minutes. More frequent calls are not allowed and will result in an error response.

This interval applies to all calls made to the given API URL, regardless of their source. Even requests from different IP addresses must be synchronized to avoid collisions, ensuring a minimum interval of 15 minutes between them to prevent error responses.

Recommendation: For regular automated transfers of candidate replies, avoid calling the API every 15 minutes. Instead, keep at least 30 minutes between scheduled requests to allow room for an unscheduled troubleshooting call if needed.

Historical data access limitation

You can use the optional from and until parameters, or additionally fromTime and untilTime, to retrieve historical candidate reply data from this API by specifying past dates. However, historical candidate reply data are available through this API only if:

  • The candidate replies were received within the last 6 months.
  • The replies were submitted after the API activation date for the respective company Teamio account. Replies submitted before that date are not available through this API.
  • The candidate is still available in Teamio. Candidates whose data processing consent has expired are automatically deleted from Teamio and will no longer be available through this API. A candidate can also be deleted manually in Teamio by a recruiter.

Troubleshooting

If your request fails, refer to the API Responses section of this documentation. It provides examples of all error responses returned by this API and explains their typical causes.