--- title: List relays --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [MoQ](https://developers.cloudflare.com/api/go/resources/moq) [Relays](https://developers.cloudflare.com/api/go/resources/moq/subresources/relays) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List relays client.MoQ.Relays.List(ctx, params) (\*SinglePage\[[RelayListResponse]()], error) GET/accounts/{account\_id}/moq/relays Lists all MoQ relays for the account. Returns only metadata. Config, status, and tokens are omitted. Results are cursor-paginated (keyset on the `created` timestamp). Use `created_before` / `created_after` with the `created` value of the first/last item in a page to fetch the adjacent page. `result_info` reports the page `count` and the `total` matching the cursor filters. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### ParametersExpand Collapse
params RelayListParams AccountID param.Field\[string] Path param: Cloudflare account identifier. Link to this property Asc param.Field\[bool]Optional Query param: Sort order by created. When true, results are returned oldest-first (ascending); otherwise newest-first (descending, the default). Link to this property CreatedAfter param.Field\[Time]Optional Query param: Cursor for pagination. Returns relays created strictly after this RFC 3339 timestamp (typically the created value of the last item on the current page, to fetch the next page). formatdate-time Link to this property CreatedBefore param.Field\[Time]Optional Query param: Cursor for pagination. Returns relays created strictly before this RFC 3339 timestamp (typically the created value of the first item on the current page, to fetch the previous page). formatdate-time Link to this property PerPage param.Field\[int64]Optional Query param: Maximum number of relays to return per page. Values above the maximum are clamped to it rather than rejected. maximum1000 minimum1 Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type RelayListResponse struct{…} Abbreviated relay for list responses. Created Time formatdate-time Link to this property Modified Time formatdate-time Link to this property Name string Link to this property UID string Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(model)%20RelayListResponse%20%3E%20(schema)>) ### List relays Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/moq" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.MoQ.Relays.List(context.TODO(), moq.RelayListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "success": true, "result": [ { "created": "2019-12-27T18:11:19.117Z", "modified": "2019-12-27T18:11:19.117Z", "name": "name", "uid": "a1b2c3d4e5f67890a1b2c3d4e5f67890" } ], "result_info": { "count": 0, "total": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "success": true, "result": [ { "created": "2019-12-27T18:11:19.117Z", "modified": "2019-12-27T18:11:19.117Z", "name": "name", "uid": "a1b2c3d4e5f67890a1b2c3d4e5f67890" } ], "result_info": { "count": 0, "total": 0 } } ```