> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get organization by ID

> Returns a specific organization by its sourcedId



## OpenAPI

````yaml /openapi/learn-with-ai/platform-api.yaml get /rostering/1.0/orgs/{sourcedId}
openapi: 3.1.1
info:
  title: TimeBack Platform API
  description: >-
    RESTful API for the TimeBack Platform. Covers authentication, rostering,
    curriculum, insights, assessments, content grading, and more.
  version: 2026.09.10.1
servers:
  - url: https://platform.dev.timeback.com
    description: integration
security: []
tags:
  - name: Auth
    description: Authentication and authorization endpoints
  - name: Organizations
    description: Organizations module contains all endpoints around organization management
  - name: Applications
    description: Applications module contains all endpoints for managing LTI applications
  - name: Users
    description: >-
      Users module contains all endpoints around user creation, update and
      consultation
  - name: Students
    description: Students module contains all endpoints around student management
  - name: Demographics
    description: >-
      Demographics module contains all endpoints around demographics
      consultation
  - name: Consent
    description: >-
      Initiate and query TimeBack parental consent for a student, backed by an
      immutable audit trail.
  - name: Classes
    description: Classes module contains all endpoints around class management
  - name: Courses
    description: Courses module contains all endpoints around course management
  - name: Enrollments
    description: Enrollments module contains all endpoints around enrollment consultation
  - name: CASE
    description: Competency and Academic Standards Exchange (CASE) 1.1 API
  - name: Curriculum
    description: Curriculum module contains endpoints for managing curriculum data
  - name: Competency Track
    description: Competency track endpoints
  - name: Content Grading
    description: >-
      Registration and management of graders for free-response content items —
      bring-your-own external graders (Tier 2) and, once shipped,
      platform-managed grading prompts (Tier 1).
  - name: Caliper
    description: The Caliper module contains all endpoints around Caliper Analytics
  - name: Insights
    description: Coaching insights and session analytics endpoints
paths:
  /rostering/1.0/orgs/{sourcedId}:
    get:
      tags:
        - Organizations
      summary: Get organization by ID
      description: Returns a specific organization by its sourcedId
      operationId: getOrganization
      parameters:
        - name: sourcedId
          in: path
          description: Unique identifier of the organization
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/fields2'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  organization:
                    $ref: '#/components/schemas/OneRosterOrgOutput'
                required:
                  - organization
        '400':
          $ref: '#/components/responses/BadRequest17'
        '404':
          description: Organization not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imsxStatusInfoDType11'
              examples:
                default:
                  value:
                    imsx_codeMajor: failure
                    imsx_severity: error
                    imsx_description: Organization not found
                    imsx_CodeMinor:
                      imsx_codeMinorField:
                        - imsx_codeMinorFieldName: TargetEndSystem
                          imsx_codeMinorFieldValue: unknownobject
        '500':
          $ref: '#/components/responses/InternalError16'
      security:
        - CognitoUserPoolAuthorizer:
            - https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly
            - https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.readonly
components:
  parameters:
    fields2:
      name: fields
      in: query
      description: >
        Comma-separated list of fields to include in the response.

        Available fields: sourcedId, status, dateLastModified, username,
        enabledUser, givenName, familyName, middleName, email, phone, sms,
        identifier, roles, grades, agents, userIds, userMasterIdentifier,
        preferredFirstName, preferredMiddleName, preferredLastName,
        primaryOrg.sourcedId, primaryOrg.type, userProfiles,
        userProfiles.profileId, userProfiles.profileType, userProfiles.vendorId,
        userProfiles.applicationId
      required: false
      schema:
        type: string
      style: form
      explode: false
  schemas:
    OneRosterOrgOutput:
      type: object
      description: Organization information in the OneRoster format
      properties:
        sourcedId:
          type: string
          description: Unique identifier for the organization
        status:
          $ref: '#/components/schemas/EntityStatus'
        dateLastModified:
          type: string
          format: date-time
          description: Timestamp of when the organization was last modified
        metadata:
          type:
            - object
            - 'null'
          description: >-
            Opaque key-value metadata for caller-defined data. Transitional: the
            5 legacy config keys below are read-only and derived from the
            organization's deprecated config columns (not stored in metadata);
            they are re-exposed here for backward compatibility with consumers
            that read config from metadata, and will be removed once those
            consumers cut over to GET /orgs/{id}/config.
          additionalProperties: true
          properties:
            privacyPolicyUrl:
              type: string
              readOnly: true
              description: Derived from the deprecated privacy_policy_url column.
            appStoreEnabled:
              type: boolean
              readOnly: true
              description: Derived from the deprecated app_store_enabled column.
            consentManagementEnabled:
              type: boolean
              readOnly: true
              description: Derived from the deprecated consent_management_enabled column.
            credentialImportMode:
              type: string
              enum:
                - enabled
                - disabled
                - inherit
              readOnly: true
              description: Derived from the deprecated credential_import_mode column.
            cameraMicDefault:
              type: string
              enum:
                - always_on
                - at_school
                - user_choice
                - always_off
              readOnly: true
              description: Derived from the deprecated camera_mic_default column.
            populationScope:
              type: string
              enum:
                - production
                - internal
                - legacy
                - test
              readOnly: true
              description: >-
                Analytics population classification from the population_scope
                column. Curated; never derived from names or emails.
        name:
          type: string
          description: Title of the organization
        type:
          type: string
          enum:
            - department
            - school
            - district
            - local
            - state
            - national
          description: Type of organization
        identifier:
          type: string
          description: External identifier for the organization
        parent:
          description: Reference to parent organization
          anyOf:
            - $ref: '#/components/schemas/OneRosterGUIDRef'
            - type: 'null'
        children:
          type: array
          items:
            $ref: '#/components/schemas/OneRosterGUIDRef'
          description: References to child organizations
      required:
        - sourcedId
        - status
        - dateLastModified
        - name
        - type
        - identifier
    imsxStatusInfoDType11:
      description: >
        This is the container for the status code and associated information
        returned within the HTTP messages received from the Service Provider.
        For the OneRoster Rostering service this object will only be returned to
        provide information about a failed request i.e. it will NOT be in the
        payload for a successful request.
      type: object
      required:
        - imsx_codeMajor
        - imsx_severity
      properties:
        imsx_codeMajor:
          description: |
            The code major value (from the corresponding enumerated vocabulary).
          type: string
          enum:
            - success
            - processing
            - failure
            - unsupported
        imsx_severity:
          description: |
            The severity value (from the corresponding enumerated vocabulary).
          type: string
          enum:
            - status
            - warning
            - error
        imsx_description:
          description: >-
            A human readable description supplied by the entity creating the
            status code information.
          type: string
        imsx_CodeMinor:
          $ref: '#/components/schemas/imsxCodeMinorDType11'
      additionalProperties: false
    EntityStatus:
      type: string
      description: Status of an entity in the system
      enum:
        - active
        - tobedeleted
        - inactive
    OneRosterGUIDRef:
      type: object
      description: A reference to another OneRoster entity
      properties:
        href:
          type: string
          format: uri
          description: URI reference to the entity
        sourcedId:
          type: string
          description: Unique identifier of the referenced entity
        type:
          type: string
          enum:
            - academicSession
            - category
            - class
            - course
            - demographics
            - enrollment
            - gradingPeriod
            - org
            - resource
            - user
          description: Type of the referenced entity
      required:
        - href
        - sourcedId
        - type
    imsxCodeMinorDType11:
      description: >
        This is the container for the set of code minor status codes reported in
        the responses from the Service Provider.
      type: object
      required:
        - imsx_codeMinorField
      properties:
        imsx_codeMinorField:
          description: |
            Each reported code minor status code.
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/imsxCodeMinorFieldDType11'
      additionalProperties: false
    imsxCodeMinorFieldDType11:
      description: |
        This is the container for a single code minor status code.
      type: object
      required:
        - imsx_codeMinorFieldName
        - imsx_codeMinorFieldValue
      properties:
        imsx_codeMinorFieldName:
          description: >-
            This should contain the identity of the system that has produced the
            code minor status code report. In most cases this will be the target
            service provider denoted as 'TargetEndSystem'.
          type: string
          default: TargetEndSystem
        imsx_codeMinorFieldValue:
          description: >
            The code minor status code (this is a value from the corresponding
            enumerated vocabulary).
          type: string
          enum:
            - fullsuccess
            - invalid_filter_field
            - invalid_selection_field
            - invaliddata
            - unauthorisedrequest
            - forbidden
            - server_busy
            - unknownobject
            - internal_server_error
      additionalProperties: false
  responses:
    BadRequest17:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/imsxStatusInfoDType11'
          examples:
            invalidData:
              value:
                imsx_codeMajor: failure
                imsx_severity: error
                imsx_description: Invalid data provided
                imsx_CodeMinor:
                  imsx_codeMinorField:
                    - imsx_codeMinorFieldName: TargetEndSystem
                      imsx_codeMinorFieldValue: invaliddata
            invalidFilter:
              value:
                imsx_codeMajor: failure
                imsx_severity: error
                imsx_description: Invalid filter field
                imsx_CodeMinor:
                  imsx_codeMinorField:
                    - imsx_codeMinorFieldName: TargetEndSystem
                      imsx_codeMinorFieldValue: invalid_filter_field
    InternalError16:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/imsxStatusInfoDType11'
          examples:
            default:
              value:
                imsx_codeMajor: failure
                imsx_severity: error
                imsx_description: Internal server error
                imsx_CodeMinor:
                  imsx_codeMinorField:
                    - imsx_codeMinorFieldName: TargetEndSystem
                      imsx_codeMinorFieldValue: internal_server_error
  securitySchemes:
    CognitoUserPoolAuthorizer:
      type: oauth2
      description: >-
        OAuth 2.0 client credentials flow. Contact timeback@trilogy.com to
        request credentials for your application.
      flows:
        clientCredentials:
          tokenUrl: https://platform.dev.timeback.com/auth/1.0/token
          scopes:
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly: roster readonly
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.readonly: roster-core readonly
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster.createput: roster createput
            https://purl.imsglobal.org/spec/lti/v1p3/scope/lti.readonly: lti readonly
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster-demographics.readonly: roster-demographics readonly
            https://timeback-platform.trilogy.com/consent/scope/consent.write: consent write
            https://timeback-platform.trilogy.com/consent/scope/consent.read: consent read
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.createput: roster-core createput
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster.delete: roster delete
            https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.delete: roster-core delete
            https://purl.imsglobal.org/spec/case/v1p0/scope/case.readonly: case readonly
            https://purl.imsglobal.org/spec/case/v1p0/scope/case.createput: case createput
            https://purl.imsglobal.org/spec/case/v1p0/scope/case.delete: case delete
            https://timeback-platform.trilogy.com/competency-track/scope/competency-track.readonly: competency-track readonly
            https://timeback-platform.trilogy.com/competency-track/scope/competency-track.write: competency-track write
            https://timeback-platform.trilogy.com/competency-track/scope/competency-track.delete: competency-track delete
            https://timeback-platform.trilogy.com/content/scope/content.write: content write
            https://timeback-platform.trilogy.com/content/scope/content.read: content read
            https://purl.imsglobal.org/spec/caliper/v1p2/scope/events.write: events write
            https://purl.imsglobal.org/spec/caliper/v1p2/scope/events.readonly: events readonly
            https://timeback-platform.trilogy.com/webhooks/scope/webhooks.write: webhooks write
            https://timeback-platform.trilogy.com/webhooks/scope/webhooks.read: webhooks read
            https://timeback-platform.trilogy.com/webhooks/scope/webhooks.delete: webhooks delete

````