Frequently Asked Questions

According to our Terms and Conditions, you must not resell, sub-license, lease or rent the obtained data to any other party.

If you want to compile our data into databases or create derivative works that are available to third parties, you must consult us first. We can then draft a separate agreement.

We are a small company and we depend on revenue to keep our APIs running and updated. Much of what we offer is available on our website for free. Our APIs are only available as paid plans.

You might be interested in our 3 month free trial to test out our API services.

We only need your contact information and we will never receive any sensitive information from our customers that would warrant a non-disclosure agreement. Our APIs are entirely self-serviced—except for bank transfers and quotes.

We generally do not accept other companies' purchase terms, NDAs, or other legal documents for the purchase of our standard packages. None of these are required to purchase access to our services. We reserve the right to make exceptions—for example for custom contracts that exceed our normal offering.

No, but you can stack packages. Upgrading would mean that your package would change – this is not the case. Instead, you can buy additional packages of the same or different sizes to stack on top of your existing package.

Example: Two Basic Packages

Let's say you want to request holiday data for two countries. The Basic package only allows for one country, so you could buy the Plus package covering all countries in our database. However, the Plus package costs 399 USD. If you instead buy two Basic packages, you only spend 2 x 99 = 198 USD and get access to two countries. This is called stacking: You buy two packages of the same kind.

What happens with the credits when stacking?

All your credits will be in one big pool. If you follow the above example and buy two Basic Holiday API packages, you will receive 2 x 50,000 = 100,000 credits. Since all credits are pooled, you can spend all your credits on one of your packages, for example to query only for one country (if you so choose).

Every package contains a number of credits. Additionally, you can buy extra credits. All your credits from all your packages and extra purchases will be treated as one pool of credits.

You use up credits by issuing successful requests: Whenever you request information from one of our endpoints via one of our APIs, and when you receive that information, credits are deducted from your account. Requests that return errors do not count as successful requests and do not cost credits.

Usually, one requests equals one credit. The exact number however depends on the API and the type of request you are making. Please refer to the documentation for more details.

Credits are tokens for your requests. To calculate how many credits you will need – and which package size is right for you – you can use our credit calculator.

You can select a service and enter your parameters such as how many countries you will query for, how often you plan to query, etc. The calculator then tells you the estimated total credits per year and which package fits your needs.

Use the credit calculator

No. In our old system, credits had an expiration date. This is no longer the case. In the new system, credits do not expire: They last until you use them. If your package expires, your credits remain in your account.

All our API services are yearly subscriptions. They are invoiced once and have to be manually renewed; we will automatically remind you before the subscription runs out.

If you want your P.O. or VAT listed on the invoice, you can either add the information to the field "reference number" on your invoice during the purchasing process or send us an email at api@timeanddate.com . Just let us know what you want included on your invoice.

You can choose one of two payment options: PayPal or bank transfer. Choosing PayPal will give you the option to pay with your credit card – you do not need a PayPal account to pay with PayPal.

If you pay via PayPal (and thus via credit card), your licenses will be activated instantly. If you pay via bank transfer, your licenses will be activated as soon as your payment is processed. This can take several business days, depending on your bank.

Generally speaking, you cannot cancel your payment obligations after your purchase. All fees, once paid, are non-refundable. However, we reserve the right to make exceptions – please contact us.

There are two ways you can do this: You can either add your P.O. and VAT number, as well as other internal remarks directly to your invoice. When you select a payment option, you can also add a "reference number" that will appear on your invoice.

Alternatively, you can complete your purchase and send us an email at api@timeanddate.com and let us know what you want to add to your invoice.

If you wish to cancel your payment method – to switch from PayPal to bank transfer, for example – please let us know via e-mail to api@timeanddate.com. We're working on a new billing system where you will be able to cancel and switch payment options yourself; but for now, please let us know, and we'll gladly switch it for you.

The two services are used for different purposes. Some users need the precise position of the Sun and the Moon at a certain point in time, others want information such as day length or the time of the sunrise.

No, we do not deliver zodiac or Moon signs. However, you can use our Astronomy API to query a location (with coordinates) for astronomical events like moonrise, moonset, and the Moon's current phase.

Our research team continously monitors changes in holidays around the globe and updates our holiday database on a regular basis. We currently do not offer a "push" for every update, but if you query our Holidays API once a week and cache the result, you remain up to date.

Yes. You can specify the country's ISO-code when querying holiday data. If you want to query on a state level, you can adapt the ISO-code. For example: If you want to query holidays for New South Wales in Australia, you would query for "country=au-nsw" instead of "country=au".

You can find a list of states and communities in our documentation.

We have developed a rule engine for our holiday database that can accurately calculate holiday dates quite far into the future: For most countries, you can query the holidays up to the year 3999.

However, in some countries, the date for specific holidays is only defined a year ahead. The reason is usually that these holidays depend on astronomical events like the sighting of the first moon.

Here you can find a list of our coverage of holidays.

While other time zone services may also list your country, our Time API offers two distinct advantages:

(1) You can query your exact location—and any location on earth—by using geo-coordinates. This means you will get the exact answer you are looking for.

(2) Our time zone database is always kept up-to-date, even with last-minute DST changes. Those changes are immediately available in our API and allow for an accurate, realistic view of time zones and times everywhere on Earth.

While our database does cover years before 1970, the coverage is not complete. Some changes were local and not well recorded, making it very hard to reliably research time zone changes before 1970.

You can query for your location using geographical coordinates, IATA/ICAO airport codes, and location IDs from our database. Querying by zip code is not possible at this time.

You can find a list of our location identifiers here: Available Locations.