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

# Get an artist

> Full profile including biography, links, associated acts, and per-role and per-genre credit counts.



## OpenAPI

````yaml /openapi.json get /v1/artists/{artistId}
openapi: 3.1.0
info:
  title: Diskograf API
  description: >-
    A public, read-only REST API over the Diskograf catalogue of Malaysian
    music.


    No authentication is required and no endpoint writes. Requests are rate
    limited

    to 60 per 60 seconds per IP address.


    Every successful response is wrapped in an envelope. List endpoints return

    `{ "data": [...], "meta": { "total", "limit", "offset" } }`; detail
    endpoints

    return `{ "data": {...} }`. Errors return `{ "error": { "code", "message" }
    }`.
  version: 1.0.0
servers:
  - url: https://api.diskograf.com
    description: Production
security: []
tags:
  - name: Songs
    description: The catalogue of published songs and their credits.
  - name: Artists
    description: Performers, writers and producers, and their discographies.
  - name: Genres
    description: The genre taxonomy and the songs in each genre.
  - name: Labels
    description: Record labels and their releases.
  - name: Users
    description: Public contributor profiles. Private account fields are never returned.
  - name: Search
    description: Cross-category keyword search.
  - name: Meta
    description: Service index, statistics and health.
paths:
  /v1/artists/{artistId}:
    get:
      tags:
        - Artists
      summary: Get an artist
      description: >-
        Full profile including biography, links, associated acts, and per-role
        and per-genre credit counts.
      operationId: getV1ArtistsByArtistId
      parameters:
        - name: artistId
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: The artist.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      name:
                        type: string
                      slug:
                        type: string
                      prefix_title:
                        anyOf:
                          - type: string
                          - type: 'null'
                      is_group:
                        anyOf:
                          - type: boolean
                          - type: 'null'
                      aliases:
                        anyOf:
                          - type: string
                          - type: 'null'
                      total_songs:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      total_credits:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      disambiguator:
                        anyOf:
                          - type: string
                          - type: 'null'
                      first_release_year:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      last_release_year:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      username:
                        anyOf:
                          - type: string
                          - type: 'null'
                      avatar_url:
                        anyOf:
                          - type: string
                          - type: 'null'
                      biodata:
                        anyOf:
                          - type: string
                          - type: 'null'
                      country:
                        anyOf:
                          - type: string
                          - type: 'null'
                      place:
                        anyOf:
                          - type: string
                          - type: 'null'
                      links:
                        type: object
                        properties:
                          website:
                            anyOf:
                              - type: string
                              - type: 'null'
                          instagram:
                            anyOf:
                              - type: string
                              - type: 'null'
                          twitter:
                            anyOf:
                              - type: string
                              - type: 'null'
                          tiktok:
                            anyOf:
                              - type: string
                              - type: 'null'
                          youtube:
                            anyOf:
                              - type: string
                              - type: 'null'
                          facebook:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - website
                          - instagram
                          - twitter
                          - tiktok
                          - youtube
                          - facebook
                      roles:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            slug:
                              anyOf:
                                - type: string
                                - type: 'null'
                            title:
                              type: string
                            count:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                          required:
                            - id
                            - slug
                            - title
                            - count
                      associated_acts:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            name:
                              type: string
                            slug:
                              type: string
                          required:
                            - id
                            - name
                            - slug
                      genres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            slug:
                              anyOf:
                                - type: string
                                - type: 'null'
                            title:
                              type: string
                            count:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                          required:
                            - id
                            - slug
                            - title
                            - count
                    required:
                      - id
                      - name
                      - slug
                      - prefix_title
                      - is_group
                      - aliases
                      - total_songs
                      - total_credits
                      - disambiguator
                      - first_release_year
                      - last_release_year
                      - username
                      - avatar_url
                      - biodata
                      - country
                      - place
                      - links
                      - roles
                      - associated_acts
                      - genres
                required:
                  - data
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    NotFound:
      description: The requested resource does not exist, or is not public.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - not_found
                      - bad_request
                      - internal_error
                  message:
                    type: string
                required:
                  - code
                  - message
            required:
              - error

````