Dates and timestamps
When can I expect the data to be available?
When can I expect the data to be available?
Data availability is guided by our SLAs (Service Level Agreements), which outline the expected timelines for data delivery. The SLAs are as follows:
- Audio Recordings: Available for 90% of events within 20 minutes after the event concludes.
- Transcripts: Available for 95% of events within 15 minutes after the event ends, provided the recording was successful.
- In-house Transcripts: Available within a couple of hours after the event ends, provided the recording was successful.
- Slide Decks: Available for 90% of events within 30 minutes of the deck being made publicly accessible.
- Interim Reports: Available for 90% of releases within 15 minutes of public availability.
- Annual Reports: Available for 90% of covered companies within 15 minutes of public release.
- Live Transcripts / Live Calls: For covered events, 90% of live content is streamed within 5 seconds of the event going live.
What time zone is the data in?
What time zone is the data in?
All timestamps are in UTC (Coordinated Universal Time). This standard time zone is used to ensure consistency and avoid confusion across different regions.
How do the updatedAt and createdAt properties relate to the events?
How do the updatedAt and createdAt properties relate to the events?
The
updatedAt and createdAt properties are timestamps that indicate when properties were last updated or created. These timestamps are crucial for tracking changes and ensuring that you have the most current information.The updatedAt property reflects the last time the data was modified, while the createdAt property indicates when the data was initially created.
The properties are not always related to the actual event date. This is the case when we add backlog material. In these cases, the updatedAt and createdAt properties might greatly differ from the event date which can be fetched from the event endpoint.Keeping data in synced state
How do I keep my data up-to-date with the latest changes?
How do I keep my data up-to-date with the latest changes?
The best way to keep your data up-to-date depends on your use case. Here are some options:
- Webhooks: Use webhooks to receive real-time notifications about changes to your data. This is ideal for applications that require immediate updates, such as live audio or transcript streaming.
- Polling: Regularly poll the API for updates. This is suitable for applications that can tolerate some delay in data freshness but still need to stay current. In order to make this method more efficient, you can use the
updatedBeforeandupdatedAfterproperties to only fetch data that has changed in a certain time window.
Is there a rate limit for the API?
Is there a rate limit for the API?
While we do not currently enforce strict rate limits, we do monitor usage patterns. If we detect excessive or abusive behavior, we may implement rate limits to ensure fair access for all users. We recommend using the API responsibly and efficiently to avoid any potential issues.
Currently, we recommend a maximum of 10 requests per second averaged over a day and a maximum of 50 requests per second for short bursts.
Update 2025-04-29We are currently working on implementing rate limits to ensure fair access for all users. We expect this to be enforced December 1, 2025. Following recommendations above will make sure you are not affected by this change. More information will be provided in the changelog.
Company identification
Which company identifiers are available?
Which company identifiers are available?
Working with company identifiers can be tricky. We provide several identifiers to help you identify companies in our system. Here are the most common ones:
- companyId: This is the unique identifier for a company in our system. It is used to reference the company in API requests and responses. These are specific to our system and are not used by any other system.
- ticker: This is the stock ticker symbol for the company. It is used to identify publicly traded companies on stock exchanges. We also provide the exchange symbol to identify the exchange where the company is listed. For example, “AAPL” for Apple Inc. on NasdaqGS.
- isin: This is the International Securities Identification Number. It is a unique identifier for securities, including stocks and bonds, and is used internationally.
Do I need to keep a local state of the company ids?
Do I need to keep a local state of the company ids?
All relevant endpoints support querying by
isin, ticker and companyId. This means you can use any of these identifiers to query the API. However, all but the company endpoints will only return the companyId in the response.When querying more than one company identifier at a time, e.g. /events?tickers=AAPL,AMZN, the API will return the companyId for each object in the response. In order to map these back to the original identifiers, you can use the /companies endpoint with the ids query parameter.
This will return the isin, ticker and companyId for each company in the response and allows you to map the identifiers back to tickers in the original request.Do you support company name searches?
Do you support company name searches?
We do not support company name searches at this time. We recommend using the
isin, ticker or companyId to identify companies in our system. This is the most reliable way to ensure you are working with the correct company. Company names are subject to change and can be ambiguous. For example, “Delta” could refer to Delta Air Lines, Delta Electronics or Delta Lithium.There are plans to implement a company name search tool in the portal to allow for searching for companies by name. This is intended to be used for exploratory purposes only when a certain company can not be identified by its ticker or isin. This is not intended to be used in production systems.Keep an eye on the changelog for updates on this feature.
Support and Incident Response
What is the best channel to communicate incidents and get support?
What is the best channel to communicate incidents and get support?
The primary and recommended channel for all support inquiries and incident reporting is your Quartr representative.
Who is the primary point of contact for support?
Who is the primary point of contact for support?
For general support and technical issues, please contact your Quartr representative. They will assist you in resolving your issue or escalate it to the appropriate team if necessary.
All technical support requests and incident reports should always be initiated through the support email channel for efficient handling.
What are your support hours?
What are your support hours?
Our standard support hours are:9:00 AM - 5:00 PM CET - Monday through Friday
For critical incidents significantly impacting core service availability outside of standard hours,
we have an on-call system to initiate response protocols.
What is the expected response time for general email inquiries?
What is the expected response time for general email inquiries?
For general support questions, feature requests, or non-critical issues submitted via email,
our target initial response time is typically within one business day during standard support hours.
What is the expected response time after an incident has been reported?
What is the expected response time after an incident has been reported?
We strive to respond to all inquiries and incidents as promptly as possible. For incidents reported via our support email, our target initial acknowledgment time is within one hour.
Response time refers to the acknowledgment of your report and the initiation of our investigation—not the full resolution of the issue.
Authentication and Authorization
How do I authenticate with the API?
How do I authenticate with the API?
To authenticate with the API, you need to include your API key in the
x-api-key header of your requests.How do I get an API key?
How do I get an API key?
You can obtain an API key by signing up for a Quartr account and navigating to the “API Keys” section in the portal. From there, you can generate a new API key and manage your existing keys.
More information on how to do this can be found in the authentication section.
How do I revoke an API key?
How do I revoke an API key?
You can revoke an API key by navigating to the “API Keys” section in the Quartr portal deleting the key you want to revoke.
Is there an expiration date for API keys?
Is there an expiration date for API keys?
API keys do not have an expiration date by default. However, you can delete them at any time from the “API Keys” section in the Quartr portal.
I'm getting a 403 Forbidden error. What does this mean?
I'm getting a 403 Forbidden error. What does this mean?
A 403 Forbidden error indicates that your API key is not authorized to access the requested resource. This could be due to several reasons:
- If you are trying to access the
/documentsendpoint, make sure you have permission to access all three document types:reports,slidesandtranscripts. If you are missing one of these permissions, you will receive a 403 Forbidden error when trying to access the endpoint. - If you are trying to access the
/liveendpoint, make sure you have permission to access bothlive transcriptsandlive audio. If you are missing one of these permissions, you will receive a 403 Forbidden error when trying to access the endpoint.