> ## Documentation Index > Fetch the complete documentation index at: https://api.aodocs.com/llms.txt > Use this file to discover all available pages before exploring further. # Get documentv2beta1documents transitions 1 > Gets transition for the document where the current user is involved. ## OpenAPI ````yaml /openapis/document.json get /document/v2beta1/documents/{documentId}/transitions/{transitionId} openapi: 3.0.1 info: description: "The AODocs REST API exposes most of the features of AODocs. It can be used to implement custom applications, third-party integration, bulk tools, or\n\t\t\t\t\t\t\t\t\t\tjust to experiment with AODocs." version: '69.4' title: AODocs REST API servers: - url: https://aodocs.altirnao.com/api security: [] tags: - name: document description: Manage documents (beta version, subject to change) paths: /document/v2beta1/documents/{documentId}/transitions/{transitionId}: get: tags: - document description: Gets transition for the document where the current user is involved. operationId: document:v2beta1.Documents.getTransition parameters: - $ref: '#/components/parameters/documentId_path_parameter' - name: transitionId in: path description: The ID of the transition required: true schema: type: string - $ref: '#/components/parameters/domain_query_parameter' - $ref: '#/components/parameters/securityCode_query_parameter' responses: '200': description: A ApiDocumentTransition response content: application/json: schema: $ref: '#/components/schemas/ApiDocumentTransition' security: - google_id_token-a99f12e0: - https://www.googleapis.com/auth/userinfo.email - google_id_token_legacy-a99f12e0: - https://www.googleapis.com/auth/userinfo.email components: parameters: documentId_path_parameter: name: documentId in: path description: The ID of the document required: true schema: type: string domain_query_parameter: name: domain in: query description: The G Suite domain required: false schema: type: string securityCode_query_parameter: name: securityCode in: query description: The security code required: false schema: type: string schemas: ApiDocumentTransition: type: object properties: createNewDocumentVersion: type: boolean description: >- Whether to create a new version of the documents via this transition (redundant with transitionType = VERSION) createdTime: type: string format: date-time description: The time at which the workflow transition was created discardCheckedOutDocument: type: boolean description: >- Whether to discard draft documents via this transition (redundant with transitionType = DISCARD) elapsedTime: $ref: '#/components/schemas/ApiElapsedTime' fieldsUsedAsValidators: type: array items: $ref: '#/components/schemas/ApiDocumentField' fixedTime: type: string format: date-time description: >- The date from which the transition should be triggered (if automatic transition based on static date/time) humanAction: $ref: '#/components/schemas/ApiHumanAction' id: type: string description: The ID of the workflow transition kind: type: string lastModifiedTime: type: string format: date-time description: The time at which the workflow transition was last modified propertyData: $ref: '#/components/schemas/ApiPropertyData' propertyTime: type: string description: >- The ID of the date (or date/time) property from whose value the transition should be triggered (if automatic transition based on property value) relativeTime: $ref: '#/components/schemas/ApiRelativeTime' targetStateId: type: string description: The ID of the target state of the transition targetStateName: type: string description: The name of the target state of the transition targetStateName_i18n: type: string description: The internationalized name of the target state of the transition transitionType: type: string description: The type of the transition enum: - NORMAL - CHECK_IN - CHECK_OUT - VERSION - DISCARD validators: type: array items: $ref: '#/components/schemas/ApiDocumentValidator' ApiElapsedTime: type: object properties: amount: type: integer format: int32 description: The amount of units to wait until the transition is triggered unit: type: string description: The unit for the elapsed time to wait (minute, hour, day, month) enum: - MINUTE - HOUR - DAY - MONTH ApiDocumentField: type: object properties: canEdit: type: boolean description: type: string description_i18n: type: string hidden: type: boolean id: type: string description: The ID of the field kind: type: string mandatory: type: boolean multiple: type: boolean name: type: string description: The name of the field name_i18n: type: string description: The internationalized name of the field (read-only field) rank: type: integer format: int32 readOnly: type: boolean system: type: boolean description: >- Indicates whether this field is a system field or not (read-only field) type: type: string enum: - STRING - TEXT - DATE - TIME - DATETIME - INTEGER - DECIMAL - BOOLEAN - PERSON - CATEGORY - GEOPOINT - URL - REFERENCE_CATALOG values: type: array items: type: string ApiHumanAction: type: object properties: actionId: type: string description: The ID of the human workflow action appliedName: type: string description: The applied name of the workflow action appliedName_i18n: type: string description: The internationalized applied name of the workflow action commentPlaceholderText: type: string description: The comment placeholder text (maximum of 80 characters) commentPlaceholderText_i18n: type: string description: The internationalized comment placeholder text (read-only field) commentPolicy: type: string description: >- The comment policy for this workflow action (FORBIDDEN, OPTIONAL, MANDATORY). Replaces mandatoryComment enum: - FORBIDDEN - OPTIONAL - MANDATORY mandatoryComment: type: boolean description: >- Deprecated: use commentPolicy. Whether a comment is mandatory when triggering the workflow action name: type: string description: The name of the workflow action name_i18n: type: string description: The internationalized workflow action performer: $ref: '#/components/schemas/ApiSecurityToken' reminders: type: array description: The list of reminders for the transition items: $ref: '#/components/schemas/ApiWorkflowTransitionReminder' validateByAll: type: boolean description: Whether the transition is a parallel transition ApiPropertyData: type: object properties: operator: type: string description: The operator of the condition enum: - EQUAL_TO - NOT_EQUAL_TO - GREATER_THAN - STRICTLY_GREATER_THAN - LESS_THAN - STRICTLY_LESS_THAN - EMPTY - NOT_EMPTY - CONTAINS - IN personValue: $ref: '#/components/schemas/ApiSecurityToken' propertyId: type: string description: The ID of the property for the condition value: type: string description: >- The value for the condition (if operator is neither EMPTY or NOT_EMPTY) ApiRelativeTime: type: object properties: after: type: boolean description: >- Whether the transition should be triggered from the property value plus the offset (vs. from the property value minus the offset) amount: type: integer format: int32 description: >- The amount of units to wait before/after the property value to trigger the transition propertyId: type: string description: The ID of the property unit: type: string description: The unit for the offset (minute, hour, day, month) enum: - MINUTE - HOUR - DAY - MONTH ApiDocumentValidator: type: object properties: comment: type: string description: User validation comment date: type: string format: date-time description: Date at which the validation occurred delegatedToCurrentUser: type: boolean description: >- Whether the current user is a delegate of this validator (only set when validated is false) user: $ref: '#/components/schemas/ApiUser' validated: type: boolean description: >- Whether the user has already processed the transition for the document ApiSecurityToken: type: object properties: classId: type: string description: The ID of the class when type = FIELD className: type: string description: The name of the class when type = FIELD description: type: string description: The description for type in GROUP, ROLE, FIELD displayName: type: string description: >- The display name of the user or group, the name of the role (read-only field) displayName_i18n: type: string description: >- The display name of the user or group, the internationalized name of the role (read-only field) thumbnailPictureUrl: type: string description: The URL of the thumbnail picture (especially for users) type: type: string description: >- The type of person (user, group, role, field based, domain i.e. everybody) enum: - USER - GROUP - ROLE - FIELD - DOMAIN value: type: string description: >- The email address if user or group, the ID of the role, the ID of the class/field (ignored if type = DOMAIN) ApiWorkflowTransitionReminder: type: object properties: audience: type: string description: >- The mode of audience to remind: PENDING (everyone in the audience of the transition except those who validated it - if parallel transition), EXCLUSIVE (for simple transitions: only the users who haven't validated the parallel transition if any on the state, for parallel transition it's similar to PENDING) enum: - PENDING - EXCLUSIVE condition: $ref: '#/components/schemas/ApiCustomScriptBinding' emailTemplateId: type: string description: >- The ID of a workflow template email (type = ACTION_REMINDER) to format reminder email id: type: string description: The ID of the reminder (read-only field) name: type: string description: The name of the reminder ApiUser: type: object properties: email: type: string kind: type: string name: type: string thumbnailPictureUrl: type: string ApiCustomScriptBinding: type: object properties: params: type: object description: The map key/value of the parameters additionalProperties: type: string scriptId: type: string description: The ID of the custom script scriptName: type: string description: The name of the custom script (read-only field) securitySchemes: google_id_token-a99f12e0: type: oauth2 x-google-issuer: https://accounts.google.com x-google-jwks_uri: https://www.googleapis.com/oauth2/v1/certs x-google-audiences: >- 755040865326-h5gomu85549lkh2qf9d3lku39vnaf6ii.apps.googleusercontent.com,563231141203-231sn7f6ptedncun5h00h7ktbe3o2nd5.apps.googleusercontent.com,993707107224.apps.googleusercontent.com,ao-docs,aodocs-core-eu-1,ao-docs-staging,ao-docs-dev,aodocs-core-dev-us,aodocs-total-poc-euw3 flows: implicit: authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth scopes: https://www.googleapis.com/auth/userinfo.email: View your email address google_id_token_legacy-a99f12e0: type: oauth2 x-google-issuer: accounts.google.com x-google-jwks_uri: https://www.googleapis.com/oauth2/v1/certs x-google-audiences: >- 755040865326-h5gomu85549lkh2qf9d3lku39vnaf6ii.apps.googleusercontent.com,563231141203-231sn7f6ptedncun5h00h7ktbe3o2nd5.apps.googleusercontent.com,993707107224.apps.googleusercontent.com,ao-docs,aodocs-core-eu-1,ao-docs-staging,ao-docs-dev,aodocs-core-dev-us,aodocs-total-poc-euw3 flows: implicit: authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth scopes: https://www.googleapis.com/auth/userinfo.email: View your email address ````