Sample - GitHub REST API
GET/notifications/threads/{thread_id}

Get a notification thread

Retrieves a notification thread by its unique identifier. Use thread_id from the id field returned by the notifications list to inspect the thread's repository, subject, read state, and subscription links.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
thread_idintegerrequired
The unique identifier of the notification thread, corresponding to the `id` field returned by the notifications list.

4 status codes
200Returns the notification thread, including its repository, subject, notification reason, unread state, timestamps, thread URL, and subscription URL.
idstringrequired
repositoryobjectrequired
Minimal Repository
subjectobjectrequired
reasonstringrequired
unreadbooleanrequired
updated_atstringrequired
last_read_atstringrequired
urlstringrequired
subscription_urlstringrequired
304Returned when the notification thread has not changed since the previous request.
401Returned when authentication is required but the request is unauthenticated or uses invalid credentials.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
403Returned when the authenticated user is not permitted to access the notification thread.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 401 is returned when authentication is required but not provided or is invalid. A 403 is returned when the authenticated user is not permitted to access the thread. thread_id must identify the notification thread you want to retrieve.