Organizations

List All Organizations

GET /organization

Returns a list of all active public organizations, including their links and streams. No auth required.

Example:

curl https://api.radioreg.net/organization

Response:

[
  {
    "id": 1,
    "name": "Example Radio",
    "description": "An example radio station",
    "image": "https://cdn.radioreg.net/logos/example.png",
    "thumbnail": "https://cdn.radioreg.net/thumbnails/example.png",
    "links": [
      { "type": "website", "url": "https://example.com" }
    ],
    "streams": [
      {
        "id": 1,
        "name": "Main Stream",
        "url": "https://stream.example.com/live"
      }
    ]
  }
]

---

Organization by ID

GET /organization/:id

Returns the details of an organization. No auth required.

Parameters:

Name	Type	Description
id	integer	Organization ID

Example:

curl https://api.radioreg.net/organization/1

Response:

{
  "id": 1,
  "name": "Example Radio",
  "description": "An example radio station",
  "image": "https://cdn.radioreg.net/logos/example.png",
  "thumbnail": "https://cdn.radioreg.net/thumbnails/example.png",
  "links": []
}

---

Organization by Name

GET /organization/name/:name

Finds an organization by its name. No auth required.

Parameters:

Name	Type	Description
name	string	Name of the organization

Example:

curl https://api.radioreg.net/organization/name/ExampleRadio

---

Random Organizations

GET /organization/limit/:limit

Returns a random selection of organizations. Useful for featured sections. No auth required.

Parameters:

Name	Type	Description
limit	integer	Number of results (max. 100)

Response:

[
  {
    "id": 1,
    "name": "Example Radio",
    "description": "An example radio station",
    "image": "https://cdn.radioreg.net/logos/example.png",
    "thumbnail": "https://cdn.radioreg.net/thumbnails/example.png"
  }
]

Example:

curl https://api.radioreg.net/organization/limit/10

---

Streams of an Organization

GET /organization/:id/streams

Returns all active streams of an organization. No auth required.

Parameters:

Name	Type	Description
id	integer	Organization ID

Example:

curl https://api.radioreg.net/organization/1/streams

Response:

[
  {
    "id": 1,
    "name": "Main Stream",
    "url": "https://stream.example.com/live",
    "tags": ["pop"],
    "organization": {
      "id": 1,
      "name": "Example Radio",
      "image": "https://cdn.radioreg.net/logos/example.png"
    },
    "song": {
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "cover": "https://cdn.example.com/cover.jpg",
      "songDuration": 200,
      "songStartedAt": 1730465520,
      "next": null
    },
    "isStreamOfTheMonth": false,
    "isNewcomerOfTheMonth": false,
    "isRecentPopularStream": false,
    "isTopVotedStream": false
  }
]