Get listed & customize your entry

How organizations appear

Directories are curated by us (Disclose Bot and disclose.io). Your organization’s appearance in a directory is driven by your published policy and its maturity rating.

If your organization isn’t claimed yet, a directory may still list it from public analysis. Directory pages offer a “Get on the list” / claim action so you can claim and manage your organization in the app. (coming soon!)

Your directory listing

Your entry in a directory is a directory listing. Through it you can:

• Show or hide your organization in that directory.
• Choose and order which policies and briefs are displayed.

Via the API

Directory listings are manageable through the Platform API:

• GET/PATCH /v1/directory_listings: read a listing and toggle its visibility.
• GET/POST/DELETE /v1/directory_listings/<id>/items: manage and reorder the policies/briefs shown, with a reorder action.

Hide your listing in a directory

curl -X PATCH https://api.disclosebot.io/v1/directory_listings/<id> \
  -H "Authorization: Bearer disclosebot_svc_xxxxxxxx" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{"data":{"type":"directory_listings","id":"<id>","attributes":{"visible":false}}}'

See the API quickstart and the Platform API reference for details.