# Your contribution summary

Source: https://docs.musicnerd.net/api-reference/users/profile-summary

Your contribution summary

## GET /api/profile/summary

Full OpenAPI specification: https://docs.musicnerd.net/spec/users.json

## Authentication

This operation requires one of the security alternatives in the specification below. Security scheme definitions are included where present in the published specification.

[Authentication guide](https://docs.musicnerd.net/authentication)

## Operation and referenced schemas

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Music Nerd API: users and profile",
    "version": "1.0.0",
    "description": "The signed-in user's own account and profile: their user name, profile photo, approved claim, contributed artists, contribution summary and the updates feed. Every route answers about the caller only; the account comes from the token, never from the request."
  },
  "servers": [
    {
      "url": "https://musicnerd-api.vercel.app",
      "description": "Production"
    },
    {
      "url": "https://musicnerd-api-staging.vercel.app",
      "description": "Staging (staging database)"
    }
  ],
  "paths": {
    "/api/profile/summary": {
      "get": {
        "summary": "Your contribution summary",
        "operationId": "getProfileSummary",
        "security": [
          {
            "privyBearer": []
          }
        ],
        "description": "The caller's contribution counts (link submissions, approved and pending, artists added, claimant edits) and their three most recent link submissions.",
        "parameters": [
          {
            "$ref": "#/components/parameters/ProfileAccountRequired"
          }
        ],
        "responses": {
          "200": {
            "description": "The summary. `Cache-Control: private, no-store`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "userId",
                    "totalContributions",
                    "approved",
                    "pending",
                    "selfEdits",
                    "artistsAdded",
                    "entries"
                  ],
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "ok"
                      ]
                    },
                    "userId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "totalContributions": {
                      "type": "integer",
                      "description": "All link submissions by the caller."
                    },
                    "approved": {
                      "type": "integer"
                    },
                    "pending": {
                      "type": "integer"
                    },
                    "selfEdits": {
                      "type": "integer",
                      "description": "Edits made as an artist's claimant."
                    },
                    "artistsAdded": {
                      "type": "integer",
                      "description": "Artists the caller added to Music Nerd."
                    },
                    "entries": {
                      "type": "array",
                      "maxItems": 3,
                      "description": "The three most recent link submissions.",
                      "items": {
                        "$ref": "#/components/schemas/ProfileEntry"
                      }
                    }
                  }
                },
                "example": {
                  "status": "ok",
                  "userId": "6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6",
                  "totalContributions": 4,
                  "approved": 3,
                  "pending": 1,
                  "selfEdits": 2,
                  "artistsAdded": 1,
                  "entries": [
                    {
                      "id": "0c7b9f2e-1d3a-4e5f-9a8b-7c6d5e4f3a2b",
                      "artistId": "aab92f80-f9e1-4299-aa33-7dd85c8de5d3",
                      "artistName": "Bio Ritmo",
                      "imageUrl": null,
                      "siteName": "bandcamp",
                      "ugcUrl": "https://bioritmo.bandcamp.com",
                      "accepted": true,
                      "createdAt": "2026-10-01 12:00:00"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/NotSignedIn"
          },
          "409": {
            "$ref": "#/components/responses/AccountChanged"
          },
          "503": {
            "description": "The database could not be read.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "status": "error",
                  "error": "Could not load your contributions. Try again."
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "ProfileAccountRequired": {
        "name": "X-Profile-Account",
        "in": "header",
        "required": true,
        "description": "The user id the page believes is signed in. Must equal the token's user, or the response is 409 so the page can refresh instead of showing another account's data.",
        "schema": {
          "type": "string",
          "format": "uuid"
        },
        "example": "6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6"
      }
    },
    "schemas": {
      "ProfileEntry": {
        "type": "object",
        "required": [
          "id",
          "artistId",
          "artistName",
          "imageUrl",
          "siteName",
          "ugcUrl",
          "accepted",
          "createdAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "artistId": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "artistName": {
            "type": [
              "string",
              "null"
            ]
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "The artist's stored portrait, as stored."
          },
          "siteName": {
            "type": [
              "string",
              "null"
            ]
          },
          "ugcUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "accepted": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "error"
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    },
    "responses": {
      "NotSignedIn": {
        "description": "No token, an invalid or expired token, or no Music Nerd user for it.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "status": "error",
              "error": "Not signed in"
            }
          }
        }
      },
      "AccountChanged": {
        "description": "`X-Profile-Account` is missing or is not the caller's id.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "status": "error",
              "error": "Account changed. Refresh and try again."
            }
          }
        }
      }
    },
    "securitySchemes": {
      "privyBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Access token",
        "description": "The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Every route here answers about that user only."
      }
    }
  }
}
```
