> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer-stage.shipbob.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-stage.shipbob.dev/_mcp/server. # Get Channels GET https://sandbox-api.shipbob.com/2026-01/channel Retrieves a paginated list of channels that the authenticated user has access to based on the provided access token. Reference: https://developer-stage.shipbob.dev/api/channels/get-channels ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: api-2026-01 version: 1.0.0 paths: /2026-01/channel: get: operationId: get-channels summary: Get Channels description: > Retrieves a paginated list of channels that the authenticated user has access to based on the provided access token. tags: - subpackage_channels parameters: - name: RecordsPerPage in: query description: >- The number of records to return per page. This parameter is used for pagination. If not provided, a default value will be used. required: false schema: type: integer default: 50 - name: Cursor in: query description: >- A cursor for pagination. This parameter is used to fetch the next set of results. required: false schema: type: string - name: Authorization in: header description: Authentication using Personal Access Token (PAT) token required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Channels.ChannelsV2ViewModel' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Channels.ErrorResponse' '401': description: Unauthorized content: application/json: schema: description: Any type '403': description: Forbidden content: application/json: schema: description: Any type servers: - url: https://sandbox-api.shipbob.com description: https://sandbox-api.shipbob.com components: schemas: Channels.ChannelViewModel: type: object properties: application_name: type: string description: Name of the application that owns the channel id: type: integer description: Unique id of the channel name: type: string description: Name of the channel scopes: type: array items: type: string description: Array of permissions granted for the channel title: Channels.ChannelViewModel Channels.ChannelsV2ViewModel: type: object properties: items: type: array items: $ref: '#/components/schemas/Channels.ChannelViewModel' description: List of channels next: type: string description: Next page url prev: type: string description: Previous page url description: Get Channels response title: Channels.ChannelsV2ViewModel Channels.ErrorResponse: type: object additionalProperties: type: array items: type: string title: Channels.ErrorResponse securitySchemes: PAT: type: http scheme: bearer description: Authentication using Personal Access Token (PAT) token OAuth2: type: http scheme: bearer description: OAuth2 authentication using JWT tokens ``` ## Examples **Response** ```json { "items": [ { "application_name": "SMA", "id": 128944, "name": "Privileged Access Token Wednesday, July 9, 2025", "scopes": [ "pricing_read", "fulfillments_write", "returns_read", "receiving_read", "fulfillments_read", "returns_write", "locations_write", "channels_read", "webhooks_write", "locations_read", "orders_write", "webhooks_read", "inventory_read", "billing_read", "receiving_write", "inventory_write", "orders_read", "products_read", "products_write" ] }, { "application_name": "ShipBob", "id": 128943, "name": "ShipBob Default", "scopes": [ "pricing_read", "returns_read", "receiving_read", "fulfillments_read", "channels_read", "locations_read", "webhooks_read", "inventory_read", "billing_read", "orders_read", "products_read" ] } ], "next": "/2026-01/channel?cursor=eyJJZCI6NzY4MzksIkN1cnNvclR5cGUiOjB5", "prev": "/2026-01/channel?cursor=eyJJZCI6NzY4NDAsIkN1cnNvclR5cGUiOjF8" } ``` **SDK Code** ```python default import requests url = "https://sandbox-api.shipbob.com/2026-01/channel" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript default const url = 'https://sandbox-api.shipbob.com/2026-01/channel'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go default package main import ( "fmt" "net/http" "io" ) func main() { url := "https://sandbox-api.shipbob.com/2026-01/channel" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby default require 'uri' require 'net/http' url = URI("https://sandbox-api.shipbob.com/2026-01/channel") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java default import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://sandbox-api.shipbob.com/2026-01/channel") .header("Authorization", "Bearer ") .asString(); ``` ```php default request('GET', 'https://sandbox-api.shipbob.com/2026-01/channel', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp default using RestSharp; var client = new RestClient("https://sandbox-api.shipbob.com/2026-01/channel"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift default import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://sandbox-api.shipbob.com/2026-01/channel")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```