Microsoft Azure Domain API

The Domain API from Microsoft Azure — 4 operation(s) for domain.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /domains/{domainName} Get a domain in the account · Microsoft Azure Get Domains Domainname #

Ask an LLM

“What are the details of one domain registered in my account?”

“Can I look up an account domain directly by its name?”

Tell an agent

Get account domain {domain}.

Show the settings of domain {domain} in my account.

GET /domains List the domains in the account · Microsoft Azure Get Domains #

Ask an LLM

“Which domains are set up in my account?”

“Can I page through the account's domain list with a skip token?”

Tell an agent

List all domains in my account.

Continue listing account domains from skip token {token}.

GET /{tenantID}/domains List domains for a directory tenant · Microsoft Azure Get Tenantid Domains #

Ask an LLM

“Which domains are verified in my directory tenant?”

“Can I filter the tenant's domain list?”

Tell an agent

List domains in tenant {tenant}.

Show tenant {tenant} domains matching {filter}.

GET /{tenantID}/domains/{domainName} Get a specific domain in a directory tenant · Microsoft Azure Get Tenantid Domains Domainname #

Ask an LLM

“Is a particular domain registered in my directory tenant?”

“What does the tenant record for one domain look like?”

Tell an agent

Get domain {domain} in tenant {tenant}.

Show the directory tenant {tenant} entry for {domain}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/microsoft-azure:microsoft-azure-domain-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Microsoft Azure Domain API
  version: '1.0'
  description: 'Operations tagged Domain across 2 of this provider''s published API definitions: dataplaneaccountclient-openapi-original.yml, graphrbacmanagementclient-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://purview.azure.com/account/
- url: https://graph.windows.net
tags:
- name: Domain
paths:
  /domains/{domainName}:
    get:
      tags:
      - Domain
      description: Get a domain
      operationId: microsoftAzureDomainsGetdomain
      parameters:
      - in: path
        name: domainName
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domain'
        default:
          description: An error response received from the provider.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
      x-ms-examples:
        Domains_GetDomain:
          $ref: ./examples/Domains_GetDomain.json
      summary: Microsoft Azure Get Domains Domainname
    servers:
    - url: https://purview.azure.com/account/
  /domains:
    get:
      tags:
      - Domain
      description: List the domains in the account.
      operationId: microsoftAzureDomainsListdomains
      parameters:
      - $ref: '#/components/parameters/api-version'
      - in: query
        name: $skipToken
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainList'
        default:
          description: An error response received from the provider.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Domains_ListDomains:
          $ref: ./examples/Domains_ListDomains.json
      summary: Microsoft Azure Get Domains
    servers:
    - url: https://purview.azure.com/account/
  /{tenantID}/domains:
    get:
      tags:
      - Domain
      operationId: microsoftAzureDomainsList
      description: Gets a list of domains for the current tenant.
      parameters:
      - name: $filter
        in: query
        required: false
        description: The filter to apply to the operation.
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/tenantIDInPath'
      responses:
        '200':
          description: OK. The operation was successful.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainListResult'
            text/json:
              schema:
                $ref: '#/components/schemas/DomainListResult'
      x-ms-pageable:
        nextLinkName: null
      x-ms-odata: '#/definitions/User'
      summary: Microsoft Azure Get Tenantid Domains
      security:
      - azure_auth:
        - user_impersonation
    servers:
    - url: https://graph.windows.net
  /{tenantID}/domains/{domainName}:
    get:
      tags:
      - Domain
      operationId: microsoftAzureDomainsGet
      description: Gets a specific domain in the current tenant.
      parameters:
      - name: domainName
        in: path
        required: true
        description: name of the domain.
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/tenantIDInPath'
      responses:
        '200':
          description: OK. The operation was successful.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domain_2'
            text/json:
              schema:
                $ref: '#/components/schemas/Domain_2'
      summary: Microsoft Azure Get Tenantid Domains Domainname
      security:
      - azure_auth:
        - user_impersonation
    servers:
    - url: https://graph.windows.net
components:
  parameters:
    api-version:
      in: query
      name: api-version
      description: The api version to use.
      required: true
      x-ms-client-name: ApiVersion
      schema:
        type: string
    tenantIDInPath:
      name: tenantID
      in: path
      required: true
      description: The tenant ID.
      x-ms-parameter-location: client
      schema:
        type: string
    ApiVersionParameter:
      name: api-version
      in: query
      required: true
      description: Client API version.
      schema:
        type: string
  schemas:
    DomainList:
      description: Paged list of domains.
      required:
      - value
      type: object
      properties:
        count:
          format: int64
          description: Total item count.
          type: integer
        nextLink:
          description: The Url of next result page.
          type: string
        value:
          description: Collection of items of type results.
          type: array
          items:
            $ref: '#/components/schemas/Domain'
    ErrorModel:
      description: Default error model
      type: object
      properties:
        code:
          description: Gets or sets the code.
          type: string
          readOnly: true
        details:
          description: Gets or sets the details.
          type: array
          items:
            $ref: '#/components/schemas/ErrorModel'
          readOnly: true
        message:
          description: Gets or sets the messages.
          type: string
          readOnly: true
        target:
          description: Gets or sets the target.
          type: string
          readOnly: true
    Identity:
      description: The Managed Identity of the resource
      type: object
      properties:
        principalId:
          description: Service principal object Id
          type: string
          readOnly: true
        tenantId:
          description: Tenant Id
          type: string
          readOnly: true
        type:
          description: Identity Type
          enum:
          - None
          - SystemAssigned
          - UserAssigned
          type: string
          x-ms-enum:
            name: ManagedIdentityType
            modelAsString: true
        userAssignedIdentities:
          description: User Assigned Identities
          type: object
          additionalProperties:
            $ref: '#/components/schemas/UserAssignedIdentity'
    UserAssignedIdentity:
      description: Uses client ID and Principal ID
      type: object
      properties:
        clientId:
          description: Gets or Sets Client ID
          type: string
          readOnly: true
        principalId:
          description: Gets or Sets Principal ID
          type: string
          readOnly: true
    SystemData:
      description: Metadata pertaining to creation and last modification of the resource.
      type: object
      properties:
        createdAt:
          format: date-time
          description: The timestamp of resource creation (UTC).
          type: string
          readOnly: true
        createdBy:
          description: The identity that created the resource.
          type: string
          readOnly: true
        createdByType:
          description: The type of identity that created the resource.
          enum:
          - User
          - Application
          - ManagedIdentity
          - Key
          type: string
          readOnly: true
          x-ms-enum:
            name: IdentityType
            modelAsString: true
        lastModifiedAt:
          format: date-time
          description: The timestamp of the last modification the resource (UTC).
          type: string
          readOnly: true
        lastModifiedBy:
          description: The identity that last modified the resource.
          type: string
          readOnly: true
        lastModifiedByType:
          description: The type of identity that last modified the resource.
          enum:
          - User
          - Application
          - ManagedIdentity
          - Key
          type: string
          readOnly: true
          x-ms-enum:
            name: IdentityType
            modelAsString: true
    ErrorResponseModel:
      description: Default error response model
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ErrorModel'
    Domain:
      description: Domain resource.
      type: object
      properties:
        containerType:
          description: Gets the container type.
          enum:
          - Domain
          - Collection
          type: string
          x-ms-enum:
            name: ContainerType
            modelAsString: true
        description:
          description: Gets or sets the description.
          type: string
        environment:
          description: Gets the environment of the domain.
          enum:
          - Prod
          - Test
          type: string
          x-ms-enum:
            name: DomainEnvironment
            modelAsString: true
        friendlyName:
          description: Gets or sets the friendly name of the domain.
          type: string
        identity:
          $ref: '#/components/schemas/Identity'
          readOnly: true
        mergeInfo:
          $ref: '#/components/schemas/DomainMergeInfo'
          readOnly: true
        name:
          description: Gets the name.
          type: string
          readOnly: true
        provisioningState:
          description: Gets the state of the provisioning.
          enum:
          - Unknown
          - Creating
          - Moving
          - Deleting
          - Failed
          - Succeeded
          type: string
          readOnly: true
          x-ms-enum:
            name: DomainProvisioningState
            modelAsString: true
        systemData:
          $ref: '#/components/schemas/SystemData'
    DomainMergeInfo:
      description: The public Domain Merge Info model.
      type: object
      properties:
        accountLocation:
          description: The account location of the source account in the merge operation.
          type: string
          readOnly: true
        accountName:
          description: The account name of the source account in the merge operation.
          type: string
          readOnly: true
        accountResourceGroupName:
          description: The resource group name of the source account in the merge operation.
          type: string
          readOnly: true
        accountSubscriptionId:
          description: The subscription id of the source account in the merge operation.
          type: string
          readOnly: true
        mergeStatus:
          description: The status of the merge operation.
          enum:
          - Succeeded
          - Failed
          - InProgress
          type: string
          readOnly: true
          x-ms-enum:
            name: MergeStatus
            modelAsString: true
    Domain_2:
      type: object
      properties:
        authenticationType:
          type: string
          description: the type of the authentication into the domain.
          readOnly: true
        isDefault:
          type: boolean
          description: if this is the default domain in the tenant.
          readOnly: true
        isVerified:
          type: boolean
          description: if this domain's ownership is verified.
          readOnly: true
        name:
          type: string
          description: the domain name.
      required:
      - name
      additionalProperties:
        type: object
      description: Active Directory Domain information.
    DomainListResult:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/Domain_2'
          description: the list of domains.
      description: Server response for Get tenant domains API call.
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.
x-refined-from:
- dataplaneaccountclient-openapi-original.yml
- graphrbacmanagementclient-openapi-original.yml
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'

Microsoft Azure Domain API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification