What it is
The Club Directory API lets another website read the public Geology365 club list. Each club includes its name, location, contact details, associations, and membership dues, including custom dues. Private club data is not included.
Access is reviewed. A key is created only after a request is approved, and each key is limited to 100 calls per rolling hour unless a different limit is set.
Appropriate uses
- Show Geology365 clubs on your own website
- Keep a federation, museum, or society list in step with Geology365
- Link visitors to a club's public Geology365 profile and dues
Inappropriate uses
- Building a mailing or phone list from club contact details
- Republishing the directory as your own product, or selling access to it
- Putting the API key in a public page, app, or visitor's browser
- Sharing one key across sites, or calling faster than the hourly limit
- Asking for officer, payment, or other private club records
Endpoints
Send your key in the X-Api-Key header. Call these from your server, not from a visitor's browser.
This returns every active club. Add ?state=Ohio or ?state=OH when you only want clubs in one state.
GEThttps://www.geology365.com/api/directory/clubs
This returns a single club. Replace {slug} with the slug from that club in the list.
GEThttps://www.geology365.com/api/directory/clubs/{slug}
A missing or revoked key returns 401. A key that has used its calls for the hour returns 429.