systemd

systemd Resolution API

The Resolution API from systemd — 4 operation(s) for resolution.

Documentation GitHub OpenAPI

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/systemd-resolution-api"

All apis

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

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.1.0
info:
  title: systemd-hostnamed (org.freedesktop.hostname1) Boot Resolution API
  version: '1.0'
  summary: D-Bus API of systemd-hostnamed modeled as REST operations.
  description: 'Documentation/contract artifact for the `org.freedesktop.hostname1` D-Bus interface on the

    system bus. Manages the system hostname (static, transient, pretty), chassis type, deployment,

    location, icon name, and other machine info.

    '
  license:
    name: LGPL-2.1-or-later
    url: https://github.com/systemd/systemd/blob/main/LICENSES/LGPL-2.1-or-later.txt
servers:
- url: dbus://system/org.freedesktop.hostname1
tags:
- name: Resolution
paths:
  /resolve/hostname:
    post:
      tags:
      - Resolution
      operationId: ResolveHostname
      summary: Resolve A Hostname To Addresses
      description: Mirrors `ResolveHostname(ifindex, name, family, flags)`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                ifindex:
                  type: integer
                  default: 0
                name:
                  type: string
                family:
                  type: integer
                  description: AF_UNSPEC=0, AF_INET=2, AF_INET6=10
                  default: 0
                flags:
                  type: integer
                  default: 0
      responses:
        '200':
          description: Resolved addresses.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddressList'
  /resolve/address:
    post:
      tags:
      - Resolution
      operationId: ResolveAddress
      summary: Resolve An Address To Hostnames
      description: Mirrors `ResolveAddress(ifindex, family, address, flags)`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - family
              - address
              properties:
                ifindex:
                  type: integer
                  default: 0
                family:
                  type: integer
                address:
                  type: array
                  items:
                    type: integer
                flags:
                  type: integer
                  default: 0
      responses:
        '200':
          description: Resolved names.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    ifindex:
                      type: integer
                    name:
                      type: string
  /resolve/record:
    post:
      tags:
      - Resolution
      operationId: ResolveRecord
      summary: Resolve A Generic DNS Resource Record
      description: Mirrors `ResolveRecord(ifindex, name, class, type, flags)`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - class
              - type
              properties:
                ifindex:
                  type: integer
                  default: 0
                name:
                  type: string
                class:
                  type: integer
                  description: DNS class (1=IN).
                type:
                  type: integer
                  description: DNS RR type (1=A
                  28=AAAA: null
                  5=CNAME: null
                  16=TXT: null
                  33=SRV: null
                  '...).': null
                flags:
                  type: integer
                  default: 0
      responses:
        '200':
          description: Array of raw RRs.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
  /resolve/service:
    post:
      tags:
      - Resolution
      operationId: ResolveService
      summary: Resolve A DNS-SD/SRV Service
      description: Mirrors `ResolveService(ifindex, name, type, domain, family, flags)`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                ifindex:
                  type: integer
                  default: 0
                name:
                  type: string
                type:
                  type: string
                domain:
                  type: string
                family:
                  type: integer
                  default: 0
                flags:
                  type: integer
                  default: 0
      responses:
        '200':
          description: Service records with TXT data.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  schemas:
    AddressList:
      type: array
      items:
        type: object
        properties:
          ifindex:
            type: integer
          family:
            type: integer
          address:
            type: array
            items:
              type: integer