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

# Create network dispute transition

> Create a network dispute transition.

POST/cases/\{token}/disputetransitions

Create a network dispute transition.

A network dispute transition is an event that changes the network state of a dispute and triggers other related events. The new state of the dispute within the network dispute lifecycle and which related events are triggered is determined by the action defined in the network dispute transition.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the dispute associated with the transition you want to create. Send a `GET` request to `/cases` to retrieve case tokens. **Allowable Values:**  36 char max |

## Request body

| Fields | Description |
| - | - |
| action string  Required | Action to take: - `RESPOND_WITH_PREARB:` Action to move a dispute to prearbitration with PULSE. - `RESPOND_WITH_ARB:` Action to move a prearbitration disputes to arbitration. - `RESPOND_WITH_PREARB_RESPONSE`: Respond to the prearbitration response. - `ACCEPT_AND_CLOSE:` Action to accept the dispute decision and close the dispute. - `CLOSE_WITH_CASE_WON`: Close with case won dispute transition. - `CLOSE_WITH_NETWORK_REJECTED`: Close with network rejected. - `REPRESENTMENT_RECEIVED`: Indicates that representment was received. **Allowable Values:**  `RESPOND_WITH_PREARB`, `RESPOND_WITH_ARB`, `RESPOND_WITH_PREARB_RESPONSE`, `ACCEPT_AND_CLOSE`, `CLOSE_WITH_CASE_WON`, `CLOSE_WITH_NETWORK_REJECTED`, `REPRESENTMENT_RECEIVED` |
| created\_by string  Optional | Indicates the user who is creating the transition. **Allowable Values:**  255 char max |
| memo string  Optional | A memo regarding the transaction. **Allowable Values:**  16777215 char max |
| network\_details object  Conditionally required | Card network details. **Allowable Values:**  See [The network\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_network_details_object) table |

### The network\_details object

Depending on the transition, contains the `prearbitration_details` object or the `arbitration_details` object.

| Fields | Description |
| - | - |
| prearbitration\_details object  Optional | Object defining the prearbitration details. **Allowable Values:**  See [The prearbitration\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_prearbitration_details_object) table |
| prearbitration\_response\_details object  Optional | Object defining the prearbitration response details. **Allowable Values:**  See [The prearbitration\_response\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_prearbitration_response_details_object) table |
| arbitration\_details object  Optional | Object defining the arbitration details. **Allowable Values:**  See [The arbitration\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_arbitration_details_object) table |
| representment\_details object  Optional | Object defining the network state details. **Allowable Values:**  See [The network\_state\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_network_state_details_object) table |
| case\_close\_details string  Optional | The new dispute state. **Allowable Values:**  See [The case\_close\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_case_close_details_object) table |

### The prearbitration\_details object

The details for prearbitration.

| Fields | Description |
| - | - |
| amount number  Required | Amount in dispute. **Allowable Values:**  32 bytes |
| attached\_contents string  Optional | Content token for documents to be submitted to the network at the current dispute state. **Allowable Values:**  256 char max |
| why\_are\_you\_initiating\_prearbitration string  Required | The reason you are initiating prearbitration. **Allowable Values:**  255 char max |
| are\_you\_providing\_new\_information boolean  Required | Indicates whether this state change includes new information useful for the dispute. **Allowable Values:**  `true`, `false` |
| summary\_of\_new\_information string Conditionally required. | A summary of the new information provided. **Allowable Values:**  255 char max |

### The prearbitration\_response\_details object

The details for prearbitration response.

| Fields | Description |
| - | - |
| attached\_contents string  Optional | Content token for documents to be submitted to the network at the current dispute state. **Allowable Values:**  255 char max |
| prearbitration\_response\_decision string  Required | The prearbitration response decision. **Allowable Values:**  `ACCEPT_PARTIAL`, `DECLINE` |
| amount string  Required | The partial acceptance amount. **Allowable Values:**  32 bytes |

### The arbitration\_details object

The details for arbitration.

| Fields | Description |
| - | - |
| attached\_contents string  Optional | Content token for documents to be submitted to the network at the current dispute state. **Allowable Values:**  255 char max |

### The representment\_details object

The details for representment transition.

| Fields | Description |
| - | - |
| amount number  Required | Amount in dispute. **Allowable Values:**  Min: 0.1 |
| attached\_contents string  Optional | Content token for documents to be submitted to the network at the current dispute state. **Allowable Values:**  255 char max |

### The case\_close\_details object

The details for case close transition details.

| Fields | Description |
| - | - |
| write\_off boolean  Optional | Indicates whether the write-off due to the case lost happened. **Allowable Values:**  `true`, `false` |

### The network\_details\_response object

Depending on the transition, contains the `prearbitration_details` object or the `arbitration_details` object.

| Fields | Description |
| - | - |
| prearbitration\_details object  Optional | Object defining the prearbitration details. **Allowable Values:**  See [The prearbitration\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_prearbitration_details_object) table |
| prearbitration\_response\_details object  Optional | Object defining the prearbitration response details. **Allowable Values:**  See [The prearbitration\_response\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_prearbitration_response_details_object) table |
| arbitration\_details object  Optional | Object defining the arbitration details. **Allowable Values:**  See [The arbitration\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_arbitration_details_object) table |
| representment\_details object  Optional | Object defining the network state details. **Allowable Values:**  See [The network\_state\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_network_state_details_object) table |
| network\_state\_details string  Optional | A JSON object, containing the details, received from the network. **Allowable Values:**  Valid JSON object |
| dispute\_state string  Optional | After the case's state has been moved to `CHARGEBACK_INITIATED`, this field will be updated as it progresses in the backend lifecycle. **Allowable Values:**  `INITIATED`, `REPRESENTMENT`, `PRE_ARBITRATION`, `ARBITRATION`, `CASE_WON`, `CLOSED`, `NETWORK_REJECTED`, `CASE_LOST`, `WRITTEN_OFF_ISSUER`, `WRITTEN_OFF_PROGRAM` |
| case\_close\_details string  Optional | New dispute case state. **Allowable Values:**  See [The case\_close\_details object](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_the_case_close_details_object) table |

## Sample request with prearbitration

```json JSON expandable lines wrap theme={null}
{
  "action": "RESPOND_WITH_PREARB",
  "created_by": "user_name",
  "memo": "pre-arb transition for testing",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.0,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "string"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "string"
      ]
    },
    "representment_details": {
      "amount": 0.10,
      "attached_contents": [
        "string"
      ]
    },
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample response with prearbitration

```json JSON expandable lines wrap theme={null}
{
  "token": "my_dispute_transition_token",
  "created_time": "2024-07-20T22:10:57.423Z",
  "last_modified_time": "2024-07-20T22:10:57.423Z",
  "case_token": "my_case_token",
  "action": "RESPOND_WITH_PREARB",
  "created_by": "user_name",
  "memo": "pre-arb transition for testing",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "network_dispute_id",
  "system_error_message": "string",
  "network_error_message": "string",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "content_token"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "content_token"
      ]
    },
    "representment_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "network_state_details": "string",
    "dispute_state": "INITIATED",
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample request with arbitration

```json JSON expandable lines wrap theme={null}
{
  "action": "RESPOND_WITH_ARB",
  "created_by": "user_name",
  "memo": "arbitration response transition response for testing",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.0,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "string"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "string"
      ]
    },
    "representment_details": {
      "amount": 0.1,
      "attached_contents": [
        "string"
      ]
    },
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample response with arbitration

```json JSON expandable lines wrap theme={null}
{
  "token": "my_dispute_transition_token",
  "created_time": "2024-07-20T22:10:57.423Z",
  "last_modified_time": "2024-07-20T22:10:57.423Z",
  "case_token": "my_case_token",
  "action": "RESPOND_WITH_ARB",
  "created_by": "user_name",
  "memo": "Arbitration response transition response for testing",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "network_dispute_id",
  "system_error_message": "string",
  "network_error_message": "string",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "content_token"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "content_token"
      ]
    },
    "representment_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "network_state_details": "string",
    "dispute_state": "INITIATED",
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample accept and close dispute request

```json JSON expandable lines wrap theme={null}
{
  "action": "ACCEPT_AND_CLOSE",
  "created_by": "user_name",
  "memo": "accept and close",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.0,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "string"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "string"
      ]
    },
    "representment_details": {
      "amount": 0.1,
      "attached_contents": [
        "string"
      ]
    },
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample accept and close dispute response

```json JSON expandable lines wrap theme={null}
{
  "token": "my_dispute_transition_token",
  "created_time": "2024-07-20T22:10:57.423Z",
  "last_modified_time": "2024-07-20T22:10:57.423Z",
  "case_token": "my_case_token",
  "action": "ACCEPT_AND_CLOSE",
  "created_by": "user_name",
  "memo": "accept and close",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "network_dispute_id",
  "system_error_message": "string",
  "network_error_message": "string",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "content_token"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "content_token"
      ]
    },
    "representment_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "network_state_details": "string",
    "dispute_state": "INITIATED",
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample close with case won dispute request

```json JSON expandable lines wrap theme={null}
{
  "action": "CLOSE_WITH_CASE_WON",
  "created_by": "user_name",
  "memo": "close with case won",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.0,
      "attached_contents": [
        "content_token"
      ],
      "why_are_you_initiating_prearbitration": "string",
      "are_you_providing_new_information": true,
      "summary_of_new_information": "string"
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "string"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "string"
      ]
    },
    "representment_details": {
      "amount": 0.10,
      "attached_contents": [
        "string"
      ]
    },
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample close with case won dispute response

```json JSON expandable lines wrap theme={null}
{
  "token": "my_dispute_transition_token",
  "created_time": "2024-07-20T22:10:57.423Z",
  "last_modified_time": "2024-07-20T22:10:57.423Z",
  "case_token": "my_case_token",
  "action": "CLOSE_WITH_CASE_WON",
  "created_by": "user_name",
  "memo": "close with case won",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "network_dispute_id",
  "system_error_message": "string",
  "network_error_message": "string",
  "network_details": {
    "prearbitration_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "prearbitration_response_details": {
      "attached_contents": [
        "content_token"
      ],
      "prearb_response_decision": "ACCEPT_PARTIAL",
      "amount": "string"
    },
    "arbitration_details": {
      "attached_contents": [
        "content_token"
      ]
    },
    "representment_details": {
      "amount": 112.5,
      "attached_contents": [
        "content_token"
      ]
    },
    "network_state_details": "string",
    "dispute_state": "INITIATED",
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Create ACCEPT\_AND\_CLOSE transition

This transition moves the network dispute state to `CASE_LOST` sets the case transition to `CLOSE` with reason code 42 (Case Lost).

For Regulation E dispute cases, if the case is past 45 days, the callee must specify both `write_off` and `write_off_actor`. When this occurs, the dispute state is set to `WRITE_OFF_PROGRAM` and sets the case transition to `CLOSE` with reason code 45 (Write off Program).

## Query parameters

| Fields | Description |
| - | - |
| action string  Required | Action taken. **Allowable Values:**  `ACCEPT_AND_CLOSE` |
| created\_by string  Required | Identifier or name of the user who created the transition. **Allowable Values:**  255 char max |
| memo string  Required | Memo regarding the transaction. **Allowable Values:**  16777215 char max |
| close\_case\_details.write\_off boolean  Conditionally required | Required if the 45-day Regulation E time limit has expired. **Allowable Values:**  `true`, `false` |
| close\_case\_details.write\_off\_actor string  Conditionally required | Triggers a `CLOSE` case transition with reason code 45. Required if the 45-day Regulation E time limit has expired. **Allowable Values:**  `PROGRAM` |

## Response fields

See the [Network dispute transition response](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse/create-network-dispute-transition-pulse.md#_network_dispute_transition_response_body) table.

## Error codes

| Error Code | Error Message | Description |
| - | - | - |
| 400301 | Case is RegE and can only be accepted and closed with write off after it expires | Triggered when attempting to do an `ACCEPT_AND_CLOSE` action without write-off information for a case that has exceeded the 45-day milestone. |

## Sample ACCEPT\_AND\_CLOSE transition request

```json JSON lines wrap theme={null}
{
  "action": "ACCEPT_AND_CLOSE",
  "created_by": "string",
  "memo": "string",
  "network_details": {
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Sample ACCEPT\_AND\_CLOSE transition response

```json JSON lines wrap theme={null}
{
  "token": "string",
  "case_token": "string",
  "action": "ACCEPT_AND_CLOSE",
  "created_by": "string",
  "memo": "string",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "string",
  "system_error_message": "string",
  "network_error_message": "string",
  "created_time": "timestamp",
  "last_modified_time": "timestamp",
  "network_details": {
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```

## Create CLOSE\_WITH\_CASE\_WON transition

For Regulation E and non-Regulation E network dispute cases, the dispute state is set to `CASE_WON` and a `CLOSE` case transition with reason code 41 (Case Won) is created.

## Sample CLOSE\_WITH\_CASE\_WON transition request

```json JSON lines wrap theme={null}
{
  "action": "CLOSE_WITH_CASE_WON",
  "created_by": "string",
  "memo": "string"
}
```

## Sample CLOSE\_WITH\_CASE\_WON transition response

```json JSON lines wrap theme={null}
{
  "token": "string",
  "case_token": "string",
  "action": "ACCEPT_AND_CLOSE",
  "created_by": "string",
  "memo": "string",
  "from_network_status": "string",
  "to_network_status": "string",
  "network_dispute_id": "string",
  "system_error_message": "string",
  "network_error_message": "string",
  "created_time": "timestamp",
  "last_modified_time": "timestamp",
  "network_details": {
    "case_close_details": {
      "write_off": true,
      "write_off_actor": "PROGRAM"
    }
  }
}
```


## Related topics

- [Create network dispute transition](https://www.marqeta.com/docs/core-api/disputes-visa/network-dispute-transitions-visa/create-network-dispute-transition-visa.md)
- [Network Dispute Transitions (Visa) Overview](https://www.marqeta.com/docs/core-api/disputes-visa/network-dispute-transitions-visa.md)
- [Network Dispute Transitions (Mastercard) Overview](https://www.marqeta.com/docs/core-api/disputes-mastercard/network-dispute-transitions-mastercard.md)
- [Network Dispute Transitions (PULSE) Overview](https://www.marqeta.com/docs/core-api/disputes-pulse/network-dispute-transitions-pulse.md)
- [Disputes (PULSE) Overview](https://www.marqeta.com/docs/core-api/disputes-pulse.md)