# Fetch a category queue by ID

- **URL:** https://marketplace.gohighlevel.com/docs/ghl/social-planner/fetch-queue-by-id
- **Summary:** Retrieves the details of a single category queue by its unique ID. The response includes a count of posts within the queue that have errors.

[Skip to main content](https://marketplace.gohighlevel.com/docs/ghl/social-planner/fetch-queue-by-id#__docusaurus_skipToContent_fallback)

Version: v3

Fetch a category queue by ID
============================

GET 

https://services.leadconnectorhq.com/social-media-posting/category/queues/:queueId

Copy for LLMView as MarkdownOpen in ClaudeOpen in ChatGPTOpen in Cursor

Retrieves the details of a single category queue by its unique ID. The response includes a count of posts within the queue that have errors.

### Requirements

#### Scope(s)

`socialplanner/category.readonly`

#### Auth Method(s)

`OAuth Access Token``Private Integration Token`

#### Token Type(s)

`Sub-Account Token`

Request[​](https://marketplace.gohighlevel.com/docs/ghl/social-planner/fetch-queue-by-id#request "Direct link to request")

### Header Parameters

**Version** stringrequired

**Possible values:** \[`v3`\]

API Version

**Example:** `v3`

### Path Parameters

**queueId** stringrequired

### Query Parameters

**locationId** stringrequired

Location ID

**Example:** `609e126a1c4ae1001291e1b5`

Responses[​](https://marketplace.gohighlevel.com/docs/ghl/social-planner/fetch-queue-by-id#responses "Direct link to Responses")

*   200
*   400
*   401
*   422

Successfully retrieved the category queue.

*   application/json

*   Schema
*   Example (auto)

**Schema**

**success**booleanrequired

**Example:** `true`

**statusCode**numberrequired

**Example:** `200`

**results** objectrequired

**message**string

A message indicating the result of the operation.

**Example:** `Queue fetched successfully`

**queue** object

The fetched queue along with its category metadata.

**_id**string

Queue ID

**Example:** `60af88475f1b2c001f5d5f4b`

**locationId**string

Location ID

**Example:** `location-123`

**categoryId**string

Category ID

**Example:** `60af88475f1b2c001f5d5f4b`

**timeSlots** object\[\]

Time slots for scheduling posts

*   Array \[\
    \
\
**dayOfWeek**numberrequired\
\
Day of the week (0-6)\
\
**Example:** `0`\
\
**time**stringrequired\
\
Time in HH:mm format\
\
**Example:** `09:00`\
\
*   \]
    

**enableFuturePosts**boolean

Enable posting future content

**Example:** `false`

**prioritizeNewContent**boolean

Prioritize new content over older content

**Example:** `false`

**currentOrder**number

Current order number in the queue

**Example:** `1000`

**status**string

Status of the queue. Possible values: active, paused, draft.

**Possible values:** \[`active`, `paused`, `draft`\]

**Example:** `active`

**startDate**string<date-time>

Start date of the queue

**Example:** `2023-01-01T12:00:00Z`

**skipDateTime**string<date-time>\[\]

Dates/times to skip posting

**Example:** `["2023-01-02T12:00:00Z"]`

**currentPostId**stringnullable

ID of the currently scheduled post

**Example:** `60af88475f1b2c001f5d5f4b`

**totalPosts**number

Total number of posts in the queue

**Example:** `10`

**lastScheduledTime**string<date-time>nullable

Timestamp of the last scheduled post

**Example:** `2023-01-01T12:00:00Z`

**createdBy**string

ID of the user who created the queue

**Example:** `user-123`

**createdAt**string<date-time>

Creation timestamp

**Example:** `2023-01-01T00:00:00Z`

**updatedAt**string<date-time>

Last update timestamp

**Example:** `2023-01-01T00:00:00Z`

**category** object

The category associated with the queue.

**_id**string

Category ID

**Example:** `6756f381be2553245b08d30c`

**name**string

Name of the category

**Example:** `Category Name`

**primaryColor**string

Primary color of the category

**Example:** `#FFFFFF`

**secondaryColor**string

Secondary color of the category

**Example:** `#000000`

**deleted**boolean

Indicates if the category is deleted

**Example:** `false`

**locationId**string

Location ID

**Example:** `fvg1TXIiVxGcdOaL0riG`

**createdBy**string

ID of the user who created the category

**Example:** `SQ6d63Va2PUbWEZ9k0TD`

**createdAt**string

Creation timestamp

**Example:** `2024-12-09T13:41:21.385Z`

**updatedAt**string

Last update timestamp

**Example:** `2024-12-09T13:41:21.385Z`

**traceId**string

    {  "success": true,  "statusCode": 200,  "results": {    "message": "Queue fetched successfully",    "queue": {      "_id": "60af88475f1b2c001f5d5f4b",      "locationId": "location-123",      "categoryId": "60af88475f1b2c001f5d5f4b",      "timeSlots": [        {          "dayOfWeek": 0,          "time": "09:00"        }      ],      "enableFuturePosts": false,      "prioritizeNewContent": false,      "currentOrder": 1000,      "status": "active",      "startDate": "2023-01-01T12:00:00Z",      "skipDateTime": [        "2023-01-02T12:00:00Z"      ],      "currentPostId": "60af88475f1b2c001f5d5f4b",      "totalPosts": 10,      "lastScheduledTime": "2023-01-01T12:00:00Z",      "createdBy": "user-123",      "createdAt": "2023-01-01T00:00:00Z",      "updatedAt": "2023-01-01T00:00:00Z",      "category": {        "_id": "6756f381be2553245b08d30c",        "name": "Category Name",        "primaryColor": "#FFFFFF",        "secondaryColor": "#000000",        "deleted": false,        "locationId": "fvg1TXIiVxGcdOaL0riG",        "createdBy": "SQ6d63Va2PUbWEZ9k0TD",        "createdAt": "2024-12-09T13:41:21.385Z",        "updatedAt": "2024-12-09T13:41:21.385Z"      }    }  },  "traceId": "string"}
> Common reference appendix (shared error/status catalog): see [../_shared-appendix.md](../_shared-appendix.md).
**name:** [Authorization](https://marketplace.gohighlevel.com/docs/ghl/social-planner/social-media-posting-api#authentication)
**type:** http**scopes:** `socialplanner/category.readonly`**scheme:** bearer**bearerFormat:** JWT**in:** header**description:** Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

*   curl
*   nodejs
*   python
*   php
*   java
*   go
*   ruby
*   powershell

*   CURL

    curl -L 'https://services.leadconnectorhq.com/social-media-posting/category/queues/:queueId?locationId=609e126a1c4ae1001291e1b5' \-H 'Accept: application/json' \-H 'Version: v3' \-H 'Authorization: Bearer <Authorization>'

RequestCollapse all

Base URL

Edit

https://services.leadconnectorhq.com

Auth

Bearer Token

Parameters

queueId — pathrequired

locationId — queryrequired

Version — headerrequired\---v3

Send API Request

ResponseClear

Click the `Send API Request` button above and see the response here!