BMLT aggregator terms of use

The BMLT aggregator collects the meeting lists of participating Narcotics Anonymous BMLT root servers into one worldwide dataset, so an app, a website or a directory can use meeting data from anywhere in one place. It is free to use, needs no key, and is run by volunteers on a small budget.

These are the terms for using that data and the service that serves it. They are meant to keep the data free and accurate for the people searching for a meeting, while asking everyone who builds on it to take their copy the way that does not slow that search down. If something here does not fit what you are building, that is a conversation, not a wall: admin@bmlt.app.

The short version

  1. NA service bodies may use the live API directly. If you are a Narcotics Anonymous service body, or you are building an official website or app for one, you may query the live API at https://aggregator.bmltenabled.org/main_server/.
  2. Everyone else uses the daily export. Third-party, commercial and non-NA apps, websites and directories take their data from the static daily export on our CDN, not from the live API. See https://cdn.aws.bmlt.app/aggregator/responsible-use.html.
  3. Attribute the source, and do not claim NA or BMLT endorsement. Show people where a meeting came from, and do not imply that Narcotics Anonymous, the BMLT project or this aggregator endorses your app.
  4. Present the meeting facts as published. You may design your own listing however you like, but do not change the facts — times, places, formats — of a meeting someone relies on to show up.
  5. The data is free to help people find meetings, and comes with no warranty. It is published by NA service bodies and their members. Use it to help people find a meeting; do not sell it as a dataset. For anything these terms do not cover, email admin@bmlt.app before building it.

Who may use the live API

The live API (https://aggregator.bmltenabled.org/main_server/) exists to answer the person searching for a meeting right now. Every request to it competes with those searches, so it is reserved for the uses that have to be live:

If that is you, use the API as you need to, cache its responses so you are not re-asking for data that has not changed, and get in touch at admin@bmlt.app if your usage is going to be heavy so we can make sure it is served well.

Everyone else: use the daily export

If you are not an NA service body — a third-party app, a commercial product, a general recovery or sober community app, a map, a directory, any project that wants a copy of the data — take your data from the daily export, not from the live API.

The export is the whole dataset published once a day as static files on our CDN, starting at https://cdn.aws.bmlt.app/aggregator/manifest.json. Each meeting line is exactly what a GetSearchResults API call returns, so code written against the API reads the export unchanged. It is served from a CDN, so pulling it costs the service nothing and you can poll it as often as you like. The full guide, including how to poll efficiently with If-None-Match, is at https://cdn.aws.bmlt.app/aggregator/responsible-use.html.

Crawling the live API to build or refresh your own database is what overloaded the service in the past — a handful of bulk copiers used more capacity than every app and website combined — and it is why the export exists. A client that pulls the whole dataset through the API, with no faster way for us to reach it, may be answered with a 403 carrying a contact address. Email admin@bmlt.app and the block is lifted as soon as we have pointed you at the export.

If the export genuinely does not fit your needs — you need data fresher than once a day, or a field it does not carry — write to admin@bmlt.app before building anything and we will work out how to get you what you need.

The data, and who owns it

The aggregator does not create the meeting data and does not claim to own it. Every meeting is published by a Narcotics Anonymous service body and its members through a BMLT root server; the aggregator only collects those lists into one place. Narcotics Anonymous meeting information is meant to be freely available so that anyone who needs a meeting can find one, and that is the spirit these terms protect.

Attribution and endorsement

Commercial use

Commercial and paid apps are welcome to use the data under these terms. Narcotics Anonymous meeting information is free, and it has to stay free:

No warranty

The data is provided as-is. It is imported from many independently run root servers and is only as current and correct as those servers are; servers the aggregator has not reached recently are held back from the main export for exactly this reason. We make no warranty that any meeting is accurate, current or still running, and we are not liable for anything that follows from relying on it. Always give people a way to confirm a meeting before they depend on it.

Changes and contact

These terms may change as the service does; the current version always lives at this address. For anything here — a use that is not covered, a block to lift, heavy API use to plan, or just to check that what you are building is fine — email admin@bmlt.app. We would far rather help you get the data the right way than turn anyone away.


Thank you for building something that helps people find a meeting.