---
title: "Change the status of a journal run"
method: PATCH
path: "/v2/providers/employers/payrolladministrations/journalruns/{journalrunId}"
tags: ["Journal run"]
---

# Change the status of a journal run

`PATCH /v2/providers/employers/payrolladministrations/journalruns/{journalrunId}`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/payrolladministrations/journalruns/{journalrunId}`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/PatchJournalRunByJournalRunId" target="_blank">PatchJournalRunByJournalRunId</a>

Update the status of a journal run
* Action 'markAsSuccessfullyExported'; will change the status of the journal run to 'exported'. Please note this action will not perform an actual export, but simply allows the user the manage status to match their actualities.</br>
* Action 'MarkAsProcessingFailed'; will change the status of the journal run to 'export failed'. Please note this action will not perform an actual export, but simply allows the user the manage status to match their actualities.

## Path parameters

- `journalrunId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Request body

- JournalrunStatusPatch
  - `action` 'MarkAsProcessed' | 'MarkAsProcessingFailed': The action to perform on the journal run * MarkAsProcessed --> (from the Loket point of view) Indicates that the client successfully processed the data (indicating that the results were imported in the financial application). * MarkAsProcessingFailed --> (from the Loket point of view) Indicates that the client was unable to process the results. Use the `message` field to communicate the error(s).
  - `application` object: The application that downloaded and processed the results
    - `key` integer
    - `value` string
  - `message` string, nullable: Message to be displayed to the Loket user

## Response `200`

OK

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `content` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)