---
title: "List MLB transactions"
method: GET
path: "/mlb/transactions"
tags: ["MLB"]
---

# List MLB transactions

`GET /mlb/transactions`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/mlb/transactions`
- Auth: API key in header `x-api-key`

Lists MLB transactions between `start_date` and `end_date`, both required in `YYYY-MM-DD` format. Covers signings, trades, options, assignments, injured-list moves and releases. Narrow with `team_id` or `player_id`. Each entry has the date, effective date, type, description, player, and from and to teams, with a total `count`.

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `team_id` string
- `player_id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbTransactionsResponseDoc
  - `code` integer
  - `data` MlbTransactionsResponse
    - `count` integer
    - `end_date` string
    - `fetched_at` string
    - `source_url` string
    - `start_date` string
    - `transactions` MlbTransaction[]
      - `date` string
      - `description` string
      - `effective_date` string
      - `from_team` MlbTeamRef
        - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
        - `id` integer: MLB team id.
        - `name` string: Full team name.
      - `id` integer
      - `player` MlbNamedRef
        - `id` integer: MLB id of the player or league.
        - `name` string: Name of the player or league.
      - `to_team` MlbTeamRef
        - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
        - `id` integer: MLB team id.
        - `name` string: Full team name.
      - `type` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)